Skip to content

Guides

CSV bulk import

Create many short links at once from a CSV file. File format, columns, limits and error messages.

Bulk import creates one short link per row of a CSV file. It's available on Pro and Ultra and in team workspaces.

Upload a file

  1. Open the dashboard.
  2. Open the … (bulk actions) menu next to New Link and choose Upload CSV.
  3. Drop in your .csv file, or click to choose it.
  4. Click Create links and wait for the summary, which reads like 48 links created, 2 failed.

File format

The first row must be a header row. Column names are case-sensitive; other columns are ignored, so you can upload an export from another tool without trimming it.

ColumnRequiredDescription
urlYesThe destination URL.
aliasNoA custom alias. Follows the alias rules. Leave empty for a generated alias.
domainNoA platform domain or an active custom domain in the workspace. Defaults to isht.app.
noteNoA private note on the link.
links.csv
url,alias,domain,note
https://example.com/spring-sale,spring-sale,isht.app,Instagram bio
https://example.com/blog/launch-day,,isht.ink,
https://example.com/pricing,pricing-2026,,Newsletter footer

Limits

  • Each created row counts toward your monthly link limit. If you've already reached it, the whole upload is rejected. Otherwise rows are created in file order until the limit is reached, and the remaining rows fail with Monthly limit of {limit} links reached. Upgrade your plan to create more.
  • Every destination goes through the link safety check.

Row errors

A row that fails doesn't stop the others. The summary lists each failed row with the reason:

MessageFix
Missing or invalid urlPut a full URL, including https://, in the url column.
Alias is used by an earlier row in this fileGive each row a different alias.
Alias already existsPick another alias, or leave it empty.
Alias can only contain alphanumeric characters, dashes, and underscoresRemove other characters from the alias.
Selected domain is not available for this workspace.Use a platform domain or one of the workspace's active custom domains.
A link safety messageThe destination was flagged; see Abuse and acceptable use.

Something missing or unclear? Email support@ishortn.ink.