How to import links from a CSV: Steps
Open the Import / Export wizard
- In the left sidebar, go to Links.
- Click the Import / Export wizard.
- Choose Upload file.
Download and understand the CSV template
Click Download our CSV template in the wizard.You’ll see headers like below. Keep names exactly as shown.
| Column (header) | Required | Accepted values / format | Notes |
|---|---|---|---|
| Long url | ✔ | A valid destination URL (e.g., https://example.org/page) | One row = one link. |
| Custom slug | — | letters, numbers, hyphen (a-z, 0-9, -) | Leave blank to auto-generate. |
| Title | — | Free text | Helps identify the link in the app (Components of a ShortPen Link). |
| Cloaking (0/1) | — | 0 or 1 | 1 = enable link cloaking (How to enable Link Cloaking in ShortPen). |
| Archived (0/1) | — | 0 or 1 | 1 = import as archived (excluded from active lists). |
| Created at | — | DD/MM/YY HH:MM or ISO (YYYY-MM-DD HH:MM) | Preserves historical creation time if provided. |
| Updated at | — | DD/MM/YY HH:MM or ISO | Optional last update timestamp. |
Fill the template
- Put each destination URL under Long url.
- (Optional) Add Custom slug (e.g.,
launch-offer). - (Optional) Add Title for clarity in your lists.
- (Optional) Set Cloaking or Archived with
0/1. - (Optional) Add Created at / Updated at to preserve history.
Upload the CSV and pick a domain
- In the wizard, click Choose file and select your CSV.
- Use the Domain dropdown to set where these links will live (e.g.,
go.yourbrand.com). - Click Start import.
Review and organize your new links (optional)
Multi-select the imported links to move to a folder or add tags in one go (great for campaign grouping).
FAQ
Can I import links into different domains at once
Can I import links into different domains at once
No. Do one upload per domain so slugs validate correctly. Repeat for the next domain.
Does the import create QR codes automatically
Does the import create QR codes automatically
Each link can have a QR Code. Enable/customize later per link if needed.
Can I update existing links with CSV
Can I update existing links with CSV
CSV import is for creating links. Use bulk actions for mass edits.
What happens if I include UTMs in the destination URL
What happens if I include UTMs in the destination URL
They’re preserved as part of the destination. For managed UTMs inside ShortPen, edit the link after import.