CSV import
Starter+
CSV bulk import
CSV import lets you create multiple short links at once by uploading a spreadsheet. Available on Starter plan and higher.
- Open your project and click the CSV button in the top bar
- Download the template and fill it in your spreadsheet app
- Click or drag & drop the CSV file onto the upload zone
- Review the results — created links and any errors
- Download the results CSV with all short URLs
Download the template file from the import page to get a correctly formatted CSV you can fill in.
File format
The file must be a valid CSV with a header row. Only the original_url column is required. All other columns are optional.
original_url,click_limit,expires_at,fallback_url
https://example.com/page1,,,
https://example.com/page2,500,2026-12-31,https://other.com
https://example.com/page3,,,
Supported columns:
| Parameter | Required | Description |
|---|---|---|
original_url | ✓ | The long URL to shorten. Must start with http:// or https://. |
click_limit | — | Maximum number of clicks. Leave empty for no limit. |
expires_at | — | Expiry date in YYYY-MM-DD format. Leave empty for no expiry. |
fallback_url | — | Where to redirect after expiry or click limit. Leave empty to show unavailable page. |
Limits
The number of links you can import per file depends on your plan:
- Starter: up to 200 links per file (matches the project link limit)
- Pro: up to 1000 links per file
- Maximum file size: 1 MB
Error handling
Rows with errors are skipped — valid rows are still imported. After import you see a results table with:
- Successfully created links with their short URLs
- Failed rows with the reason (invalid URL, limit reached, etc.)
You can download the results as CSV to get a list of all short URLs created.