Skip to content
Import and Export Links

Import and Export Links

Availability: Importing and exporting links is available on every plan, including Free. Imported links follow your plan’s limits and features.

Import links

On Links, open Import links and choose where the links come from:

  • Bitly API, Dub API, Rebrandly API, Short.io API or TinyURL API: Shortn reads your links straight from the provider.
  • CSV or JSON file: an export from another tool, or your own list.

From a provider’s API

  1. Paste an API key or token from the provider. Shortn uses it only to discover links for this import.
  2. Optionally narrow what’s discovered, with the filters the provider supports (domain, search, tags, archived links, and so on). Select Discover links.
  3. Pick the links to import. You can search the list and Select all.
  4. Choose the Import destination: the workspace and, optionally, teams.
  5. Choose domains. With Preserve custom domains when available, a link keeps its custom domain if that domain is added to Shortn and available in the workspace; otherwise it uses the workspace’s default domain. You can also set a Per-link domain for individual links.
  6. For password-protected links, enter a password (at least 8 characters) for each one you want to keep protected. Providers don’t share passwords, so a link you leave blank is imported without one.
  7. Under Additional settings, choose which of the provider’s settings to bring along (see the table below).
  8. Select Preview to check the result, then Import links.
ProviderSettings Shortn can import besides the destination, title and short code
BitlyExpiration date, archived status, tags
DubExpiration date, status, UTM parameters, targeting, cloaking, custom previews, tags
RebrandlyExpiration date, tags
Short.ioExpiration date, archived status, targeting, cloaking, tags
TinyURLExpiration date, archived status, tags

From a file

  1. Choose CSV or JSON file.
  2. Pick the Provider the file comes from (Bitly, Dub, Rebrandly, Short.io, TinyURL, or Generic) and its Format (CSV or JSON).
  3. Choose the file, or paste the data under Import data.
  4. Choose the workspace and, optionally, teams.
  5. Select Preview, then Import links.

Each provider’s export is mapped to Shortn automatically. A Generic file uses columns such as url (or original_url), title, short_code (or custom_code), description, the UTM fields, and start and expiration times. A CSV without a header row is read as url, title, short_code, description, in that order.

How imports work

  • Preserve short codes (on by default) keeps each link’s original short code where it can. Codes follow the same rules as custom short codes. From a provider, a code that’s taken or not allowed gets a new random code instead.
  • Skip duplicates (on by default) skips links whose destination already exists in the workspace (or the chosen teams), or whose short code is already taken, instead of reporting them as failed. Preserve short codes needs it on.
  • Plan limits apply to each link. A link that needs a feature your plan doesn’t include, such as scheduling, a password, targeting or A/B testing, fails with the plan’s message. When your plan has no room for more active links, the provider import offers Import links over the limit as archived (on by default): those links arrive archived, which doesn’t count toward the limit, and you can restore them when you have room.
  • Tags are matched by name: an existing tag with the same name is reused, and missing ones are created.
  • Expiration carries over. An imported expiration with no action, or with delete, becomes Suspend (see Schedule and expire links).
  • Passwords need at least 8 characters, instead of the 12 required for new links, because they’re already shared with their audience.
  • Destinations are checked like any new link’s: they must be http:// or https://, pass the security check, and not be short links themselves.

The result lists how many links were created, skipped or failed, with the reason for each.

Export links

On Links, open Export to download your links with their metadata, teams, domains, tags, clicks, UTM parameters, QR settings and advanced settings.

  • Format: CSV or JSON.
  • Use current filters (on by default): export exactly what the list shows, with its search, filters, ordering and active/inactive selection. Turn it off to export every link you can access, and choose whether to Include inactive links.

An export holds at most 10,000 links. If there are more, narrow the export with filters and export the rest separately.

Last updated on