The 📥 Link Importer add on exists for one job: creating a lot of tracking links at once from a CSV file, so you do not have to fill in the Create Link form hundreds of times.
What You Need In The File:
A CSV with, at minimum, a slug column and a destination URL column. A link title column is optional. Column order does not matter because you map the columns in the importer.
Running An Import:
- Open the Import tab and the 📥 Import Links from CSV screen.
- Choose your CSV File and upload it.
- On the 🔗 Map Your Columns step, match your spreadsheet columns to the fields the importer expects. Slug and Destination URL are required, and Link Title is optional.
- Check the 👁️ Data Preview, which shows the first five rows exactly as they will be imported. This is where you catch a header row being treated as data, or a column mapped one place to the left.
- Run the import.
Duplicate Slug Protection:
If a slug in your file already exists on the site, the importer does not overwrite the existing link. It appends a number to make the new slug unique, so an incoming my-offer becomes my-offer-2. Nothing you already had is lost.
The CSV Format Guide:
The import screen carries a 📋 CSV Format Guide showing the expected structure. If an import behaves oddly, compare your file against that guide before anything else, because the usual culprits are a missing header row, an unexpected delimiter, or smart quotes pasted in from a word processor.
Preparing A Clean File:
- Save as plain CSV, not as an Excel workbook.
- Use one row per link, with a single header row at the top.
- Keep slugs simple: lowercase letters, numbers and hyphens.
- Make sure destination URLs include the protocol, so https://example.com rather than example.com.
- Import a five row test file first, confirm the links redirect, then import the full list.
After Importing:
Imported links behave exactly like links created by hand. Assign them to folders from the Links tab or the Edit Link form, add feed titles if any of them belong in the public feed, and remember that Sub-IDs work on imported links immediately with no extra configuration.