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

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 successfully imported

- Number of links that failed

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. Slug must be unique
4. 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