Back to blog

How to Import Your Links into Klyqme from Bitly, Rebrandly, or CSV

Step-by-step guide to importing your short links into Klyqme from Bitly, Rebrandly, or a CSV file. Covers token setup, import options, and troubleshooting.

Klyqme
7 min read
How to Import Your Links into Klyqme from Bitly, Rebrandly, or CSV
Share:

Switching URL shorteners shouldn't mean starting from scratch. If you have hundreds or thousands of short links sitting in Bitly, Rebrandly, or a spreadsheet, Klyqme's import tool brings them all in: slugs, titles, tags, and creation dates.

The import feature is available on the Growth plan. It supports three sources: a CSV file upload (works with exports from any shortener), a direct connection to Bitly via access token, and a direct connection to Rebrandly via API key. Imports run in the background, so you can close the dialog and come back later to check progress.

This guide walks through each method step by step.

Start free with Klyqme

Import from a CSV File

CSV import is the most flexible option. It works with exports from any URL shortener (Bitly, TinyURL, Short.io, Dub.sh) and with custom spreadsheets you've built yourself.

File Requirements

Your file needs to be a standard .csv (comma-separated values) with UTF-8 encoding. The maximum file size is 10 MB, which covers roughly 50,000 rows depending on URL length. The first row must be column headers.

Columns

The only required column is the destination URL. Everything else is optional.

ColumnRequiredDescriptionExample
URLYesThe destination URLhttps://example.com/my-page
SlugNoCustom short link pathmy-page
TitleNoLink title or descriptionMy Landing Page
TagsNoComma, semicolon, or pipe-separatedmarketing, campaign-q1
CreatedNoOriginal creation date (ISO format)2025-06-15

You don't need to rename your columns. The importer auto-detects common header names from most shortener exports:

  • URL column: url, link, long_url, longurl, destination, destination_url, original_url, original, target, target_url, redirect, redirect_url, webpage
  • Slug column: slug, short_url, shorturl, short_link, shortlink, custom_id, customid, alias, keyword, back_half, backhalf, slashtag
  • Title column: title, name, label, description
  • Tags column: tags, tag, labels, categories, category
  • Date column: created_at, createdat, created, date, date_created, timestamp

Example CSV

url,slug,title,tags
https://example.com/landing,my-landing,Landing Page,"marketing, q1"
https://example.com/blog,blog-post,Blog Post,content
https://example.com/pricing,,Pricing Page,

The third row has no slug. Klyqme generates one automatically.

Steps

  1. Go to Settings > Import in your Klyqme dashboard.
  2. Click Import Links.
  3. Select CSV.
  4. Upload your .csv file.
  5. The importer previews your data and shows the detected column mapping. Verify that each column maps correctly.
  6. Configure your import options (domain, duplicates, slugs, tags).
  7. Click Start Import.

A few things to know: rows with invalid URLs are skipped silently. If a slug you're importing already exists on your domain, the system tries appending -1 to the slug. If that's also taken, it generates a random one. Tags that don't exist in your team's tag list are created automatically with a default indigo color.

Import from Bitly

Direct Bitly import pulls your links, slugs, titles, and tags through the Bitly API. No CSV export needed.

Generate Your Bitly Access Token

You need a Generic Access Token from your Bitly account. This is a one-time setup.

  1. Log in to your Bitly account at bitly.com.
  2. Click your profile avatar in the top-right corner.
  3. Select Settings.
  4. In the left sidebar, click API. Or go directly to app.bitly.com/settings/api.
  5. Under "Generic Access Token," enter your Bitly account password.
  6. Click Generate Token.
  7. Copy the token immediately. Bitly won't show it again after you leave the page.

Token generation is available on all Bitly plans, including the free tier. The token is a long alphanumeric string with no scopes or permissions to configure. It inherits the full access of your account.

Connect and Import

  1. In Klyqme, go to Settings > Import and click Import Links.
  2. Select Bitly.
  3. Paste your Generic Access Token.
  4. Click Connect.
  5. Klyqme fetches your Bitly groups. If you have more than one group, select which one to import from.
  6. The total link count is displayed. Review the number to confirm it looks right.
  7. Configure your import options.
  8. Click Start Import.

The import processes 50 links per page with a built-in delay between API calls to respect Bitly's rate limits. Custom back-halves from Bitly are preserved as slugs in Klyqme when available. Tags transfer over as-is.

For large Bitly accounts, there's an alternative: you can export your links as CSV directly from the Bitly dashboard (Links page > Export) and use the CSV import method instead. Bitly emails the export file, which can take up to 30 minutes for large accounts.

Import from Rebrandly

Rebrandly import uses an API key instead of an access token. The connection process is otherwise the same.

Generate Your Rebrandly API Key

  1. Log in to your Rebrandly account at app.rebrandly.com.
  2. Click your account icon in the top-right corner.
  3. Select Account settings.
  4. Click the API keys tab. Or go directly to app.rebrandly.com/account/api-keys.
  5. Click Generate new API key.
  6. Copy the key immediately and store it somewhere safe.

API key generation is available on all Rebrandly plans. Paid accounts can create up to 10 keys for different integrations. The key provides full account access; there are no permission scopes to configure.

Connect and Import

  1. In Klyqme, go to Settings > Import and click Import Links.
  2. Select Rebrandly.
  3. Paste your API Key.
  4. Click Connect.
  5. Klyqme validates the key and shows the total number of links in your account.
  6. Configure your import options.
  7. Click Start Import.

Links, slashtags (imported as slugs), and titles are all transferred. The importer uses cursor-based pagination at 25 links per page.

If you have a large Rebrandly account and prefer not to use the API, Rebrandly also allows exporting links from the dashboard. You can then upload that export using the CSV import method described above.

Import Options

Before starting any import, you'll see four configuration options. These apply to all three import methods.

OptionDefaultWhat It Does
Target DomainYour team's default short domainDetermines which domain the imported short links are created on. If you have custom domains configured in Klyqme, you can select one here.
Duplicate HandlingSkip duplicatesSkip means links whose destination URL already exists on your team won't be imported again. Import all creates new short links regardless of duplicates.
Preserve Original SlugsOnKeeps the original slug or back-half from your source. If the slug is already taken on your Klyqme domain, the system tries appending -1. If that's also taken, a random slug is generated.
Import TagsOnImports tags from the source and assigns them to each link. Tags that don't already exist in your team's tag list are created automatically with a default indigo color.

For most migrations, the defaults work well. The one setting worth considering is duplicate handling: if you've already created some of these links in Klyqme, "Skip duplicates" prevents them from being imported again.

Import your links now

Tracking Import Progress

After clicking Start Import, a progress bar shows real-time status. The page polls for updates every two seconds.

You'll see a live counter showing how many links have been processed out of the total, along with the number of successful and failed imports. The progress bar turns green when the import finishes successfully, or red if something went wrong.

You can close the import dialog at any point. The import continues in the background. To check on it, go back to Settings > Import. All past and active imports are listed there with status badges:

  • Pending: queued, not yet started
  • Processing: currently running
  • Completed: finished successfully
  • Failed: stopped due to an error
  • Cancelled: stopped by you

To cancel a running import, find it in the list and click the cancel button. Links already imported before cancellation remain in your account.

FAQ

The importer auto-detects a wide range of common column names. For destination URLs, it recognizes headers like `long_url`, `destination`, `original_url`, `target_url`, `redirect`, and `webpage`. Slug-related headers such as `back_half`, `slashtag`, `alias`, and `keyword` are also picked up automatically. If your column names are truly unusual, rename the headers in the first row of your CSV to match one of the supported names before uploading.

It depends on your Duplicate Handling setting. With "Skip duplicates" (the default), any link whose destination URL already exists on your team is silently skipped. With "Import all," a new short link is created for every row regardless. The duplicate check is based on the destination URL, not the slug.

If "Preserve Original Slugs" is enabled and the slug you're importing conflicts with an existing short link on your Klyqme domain, the system tries appending `-1` to the slug. If that's also taken, a random slug is generated instead. If the slug could not be preserved, you can update it manually after the import completes.

Yes. Go to **Settings > Import**, find the import job in the list, and click cancel. Jobs with "Pending" or "Processing" status can be cancelled. Links that were already imported before cancellation stay in your account.

Import is available on the **Growth plan**. Free and Core users see an upgrade prompt when they try to access the import page. [See plans](/#pricing).

CSV imports are capped at 50,000 rows per file (10 MB max). Bitly and Rebrandly API imports have no hard limit on the Klyqme side; the practical ceiling is the number of links in your source account. For very large imports (10,000+ links), the process may take several minutes. You can close the dialog and check back later.

Tags from your source (CSV, Bitly, or Rebrandly) are matched against your existing Klyqme tags by name. If a tag doesn't already exist, it's created automatically with a default indigo color. You can change tag colors later in **Settings > Tags**.

References

Stay in the loop

Get product updates and tips delivered to your inbox.

We use cookies

We use cookies to improve your experience on our site. By continuing to browse, you agree to our use of cookies.