Importing Links from CSV

Step: Prepare Your CSV File

1. Create a CSV file with your link data
2. Supported columns:

- slug (optional): Custom short code

- destination_url (required): Full URL to redirect to

- title (optional): Link title

- description (optional): Link description

- redirect_code (optional): 301, 302, 307, or 308

- category (optional): Category name

- tags (optional): Comma-separated tag names

1. Save the file as .csv, .tsv, or .txt

Step: Open Import Modal

1. On the Dashboard page, click the "Import CSV" button
2. The Import Links from CSV modal will open

Step: Select File

1. Click the "Choose File" button or drag and drop your CSV file
2. The file will be loaded

Step: Configure Import Settings

1. Field Delimiter: Select the character that separates fields:

- Auto-detect (recommended)

- Comma (,)

- Tab

- Semicolon (;)

- Pipe (|)

- Custom (enter your delimiter)

1. Domain: Select the domain for all imported links

- Important: Only one domain per CSV file

1. If a slug already exists: choose what happens when a row's slug is already used on the domain:

- Skip (default): the existing link is left untouched and the row is counted as skipped

- Show error: the row is reported as an error

- Update the existing link: non-blank cells overwrite the link's fields; blank cells leave a field unchanged; a non-blank tags cell replaces the link's tags

Step: Map Columns

1. After file selection, a column mapping section will appear
2. For each CSV column, select the corresponding field from the dropdown
3. Leave unmapped if a column is not needed
4. Review the preview table showing the first 5 rows

Step: Import Links

1. Review the preview to ensure data looks correct
2. Click the "Import Links" button
3. An import progress modal will appear

Step: Monitor Progress

1. Watch the progress bar and percentage
2. The progress text will show current status
3. Wait for the import to complete

Step: Review Results

1. After completion, you'll see a summary:

- Number of links created, updated and skipped

- Number of rows with errors (error rows show their CSV row number)

1. If there are errors, click "View Error Details" to see specific issues
2. Click "Download Error Report" to get a CSV of failed rows
3. Click "OK" to close the modal

Tips for Successful Imports

1. Ensure destination URLs are valid and complete (include http:// or https://)
2. Category and tag names must match existing ones (or they'll be created)
3. Re-importing the same file is safe: with the default Skip mode, existing slugs are not changed or duplicated
4. New links get the domain's default retargeting pixels automatically
5. A slug that belongs to a deleted link can't be reused until that link is restored or permanently deleted
6. Check the preview before importing

Exporting Links to CSV

Step: Apply Filters (Optional)

1. Use search, tag filter, or category filter to narrow down links
2. Only filtered links will be exported

Step: Export

1. Click the "Export CSV" button in the Link Management section header
2. A CSV file will be downloaded with all visible links
3. The file includes: slug, destination URL, title, description, clicks, status, category, tags, created date