Links aus einer CSV-Datei massenimportieren

Wenn Sie eine Tabelle mit Ziel-URLs haben, die Sie alle auf einmal kürzen möchten — Migration von einem anderen Tool, Start einer Kampagne oder Befüllen eines neuen Workspace — ist der Massenimporter der richtige Weg. Er zeigt Fehler vorab an, bevor etwas übergeben wird, sodass Sie Probleme ohne teilweise Importe beheben können.

CSV-Format#

Der Importer erwartet eine kommagetrennte Datei mit einer Kopfzeile. Die einzige erforderliche Spalte ist destination. Alles andere ist optional.

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

Spaltenregeln:

• destination (erforderlich) — die vollständige URL einschließlich https://. URLs ohne Schema werden abgelehnt.
• slug (optional) — ein benutzerdefinierter Kurz-Slug. Nur Buchstaben, Zahlen und Bindestriche. Wenn leer, generieren wir einen zufälligen 6-stelligen Code.
• title (optional) — eine für Menschen lesbare Beschriftung, die in der Linkliste angezeigt wird.
• tags (optional) — ein oder mehrere Tags, durch Doppelpunkte oder Semikolons getrennt. Tags werden automatisch erstellt, wenn sie noch nicht existieren.

Die Reihenfolge der Spalten spielt keine Rolle, solange die Kopfzeilennamen übereinstimmen. Zusätzliche Spalten werden ignoriert.

Import starten#

1. Gehen Sie zu Tools → Massenimport (oder klicken Sie auf die Import-Schaltfläche unter Links).
2. Laden Sie Ihre CSV-Datei hoch. Der Importer analysiert sie und zeigt eine Vorschautabelle.
3. Prüfen Sie die Vorschau. Jede Zeile mit einem Fehler wird hervorgehoben — fahren Sie über das Fehlersymbol, um zu sehen, was falsch ist.
4. Klicken Sie auf Importieren, um die gültigen Zeilen zu schreiben. Fehlerhafte Zeilen werden übersprungen.

Der Import läuft im Hintergrund. Bei großen Dateien zeigt ein Fortschrittsindikator, wie viele Zeilen verarbeitet wurden. Sie erhalten eine Zusammenfassungs-E-Mail, wenn er abgeschlossen ist.

Das 50.000-Link-Cap#

Jeder Importdurchlauf ist auf 50.000 Zeilen begrenzt. Wenn Ihre Datei größer ist, teilen Sie sie in mehrere Dateien auf und führen Sie diese nacheinander aus. Es gibt kein Tageslimit für Importdurchläufe.

Deduplizierung#

Der Importer prüft Slugs gegen vorhandene Links. Wenn der Slug einer Zeile bereits im Workspace existiert:

• Die Zeile wird mit einem Fehler übersprungen („Slug bereits vergeben").
• Der vorhandene Link wird nicht geändert.

Wenn die Slug-Spalte leer ist, generieren wir immer einen neuen eindeutigen Code, sodass leere Slug-Zeilen nie in Konflikt geraten.

Wenn Sie eine zuvor teilweise verarbeitete Datei erneut importieren, ist der Importer für leere Slug-Zeilen idempotent (jeder Durchlauf erstellt neue Links mit neuen Codes). Für explizite Slugs werden nur Zeilen mit Slugs erfolgreich sein, die noch nicht im Workspace vorhanden sind.

Häufige Import-Fehler und Behebungen#

„Ungültige URL" — das Ziel enthält kein Schema (https://) oder enthält Zeichen, die in einer URL nicht gültig sind. Korrigieren Sie die Zelle in Ihrer Tabelle und laden Sie erneut hoch.

„Slug bereits vergeben" — ein Link mit diesem Slug existiert bereits. Entfernen Sie entweder den Slug, um einen automatisch generierten zu erhalten, oder ändern Sie ihn in etwas Einzigartiges.

„Slug enthält ungültige Zeichen" — Slugs können nur Buchstaben (a-z, A-Z), Zahlen (0-9) und Bindestriche (-) enthalten. Leerzeichen, Unterstriche und Punkte sind nicht erlaubt.

„Datei zu groß" — die Datei überschreitet das 50.000-Zeilen-Cap. Teilen Sie sie auf und importieren Sie in Batches.

„Ziel blockiert" — unser URL-Scanner hat das Ziel als bösartig oder in einer blockierten Kategorie markiert. Wenn Sie glauben, dass dies ein False Positive ist, kontaktieren Sie den Support mit der URL.

Fehlerbehebung#

Mein Import wurde abgeschlossen, aber einige Zeilen fehlen. Laden Sie den Import-Bericht herunter — ein Link erscheint in der Import-Zusammenfassung. Der Bericht zeigt, welche Zeilen übersprungen wurden und warum. Die meisten Übersprungenen sind doppelte Slugs oder ungültige URLs.

Der Importer sagt, die Datei ist fehlerhaft. Stellen Sie sicher, dass die Datei tatsächlich CSV ist (nicht TSV oder Excel .xlsx). Öffnen Sie sie in einem Texteditor und bestätigen Sie, dass Kommas das Trennzeichen sind und die Kopfzeile vorhanden ist.

Import hängt bei „Verarbeitung". Große Importe (Zehntausende von Zeilen) können einige Minuten dauern. Aktualisieren Sie die Seite, um den aktuellen Status zu überprüfen. Wenn er nach 10 Minuten immer noch hängt, kontaktieren Sie den Support mit der in der URL angezeigten Import-ID.