Links in bulk importeren vanuit een CSV

Als je een spreadsheet met bestemmings-URL's hebt die je in één keer wilt verkorten — bij migratie vanaf een andere tool, het lanceren van een campagne, of het opbouwen van een nieuwe workspace — is de bulkimporttool de juiste weg. Deze toont fouten in preview voordat er iets wordt vastgelegd, zodat je problemen kunt oplossen zonder gedeeltelijke imports.

CSV-formaat

De importtool verwacht een kommagescheiden bestand met een kopregel. De enige verplichte kolom is destination. Al het andere is optioneel.

destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact

Kolomregels:

• destination (verplicht) — de volledige URL inclusief https://. URL's zonder scheme worden afgewezen.
• slug (optioneel) — een custom korte slug. Alleen letters, cijfers en koppeltekens. Indien leeg, genereren we een willekeurige code van 6 tekens.
• title (optioneel) — een leesbaar label dat wordt getoond in de linklijst.
• tags (optioneel) — een of meer tags gescheiden door dubbele punten of puntkomma's. Tags worden automatisch aangemaakt als ze nog niet bestaan.

De volgorde van kolommen maakt niet uit, zolang de kopnamen overeenkomen. Extra kolommen worden genegeerd.

Een import starten

1. Ga naar Tools → Bulk import (of klik op de importknop bij Links).
2. Upload je CSV-bestand. De importtool verwerkt het en toont een previewtabel.
3. Bekijk de preview. Elke rij met een fout wordt gemarkeerd — beweeg over het foutpictogram om te zien wat er mis is.
4. Klik op Import om de geldige rijen op te slaan. Rijen met fouten worden overgeslagen.

De import wordt op de achtergrond uitgevoerd. Bij grote bestanden toont een voortgangsindicator hoeveel rijen zijn verwerkt. Je ontvangt een samenvattings-e-mail zodra het klaar is.

De limiet van 50.000 links

Elke import is beperkt tot 50.000 rijen. Als je bestand groter is, splits het dan op in meerdere bestanden en voer ze na elkaar uit. Er is geen dagelijkse limiet op het aantal imports.

Deduplicatie

De importtool controleert slugs tegen bestaande links. Als de slug van een rij al bestaat in de workspace:

• Wordt de rij overgeslagen met een fout ("slug already taken").
• Wordt de bestaande link niet gewijzigd.

Als de slugkolom leeg is, genereren we altijd een nieuwe unieke code, zodat rijen zonder slug nooit botsen.

Als je een bestand opnieuw importeert dat je eerder gedeeltelijk hebt verwerkt, is de importtool idempotent voor rijen zonder slug (elke run maakt nieuwe links aan met nieuwe codes). Voor expliciete slugs slagen alleen rijen met slugs die nog niet bestaan in de workspace.

Veelvoorkomende importfouten en oplossingen

"Invalid URL" — de bestemming bevat geen scheme (https://) of bevat tekens die niet geldig zijn in een URL. Corrigeer de cel in je spreadsheet en upload opnieuw.

"Slug already taken" — er bestaat al een link met die slug. Verwijder de slug om een automatisch gegenereerde te krijgen, of wijzig deze naar iets unieks.

"Slug contains invalid characters" — slugs mogen alleen letters (a-z, A-Z), cijfers (0-9) en koppeltekens (-) bevatten. Spaties, underscores en punten zijn niet toegestaan.

"File too large" — het bestand overschrijdt de limiet van 50.000 rijen. Splits het en importeer in batches.

"Destination blocked" — onze URL-scanner heeft de bestemming gemarkeerd als schadelijk of behorend tot een geblokkeerde categorie. Als je denkt dat dit een fout-positief is, neem dan contact op met support met de URL.

Problemen oplossen

Mijn import is voltooid, maar sommige rijen ontbreken. Download het importrapport — er verschijnt een link in de importsamenvatting. Het rapport toont welke rijen zijn overgeslagen en waarom. De meeste overgeslagen rijen zijn duplicaatslugs of ongeldige URL's.

De importtool zegt dat het bestand ongeldig is. Zorg ervoor dat het bestand daadwerkelijk CSV is (geen TSV of Excel .xlsx). Open het in een teksteditor en controleer of komma's het scheidingsteken zijn en de kopregel aanwezig is.

Import blijft hangen op "processing". Grote imports (tienduizenden rijen) kunnen enkele minuten duren. Ververs de pagina om de huidige status te controleren. Als het na 10 minuten nog steeds vastzit, neem dan contact op met support met het import-ID dat in de URL wordt getoond.