Bulk Migration · CSV Link Importer

Import Links. Migrate links from other software into Recut.

This tool allows you to import links in bulk from other software. Format your CSV file with four positional columns and let Recut provision your short links with custom aliases, titles, and descriptions.

Get Started for Free

Files up to 2048 MB · Async background queue for >100 links · Auto deduplication

CSV Importer Structure5 Sample Rows

Col 1longurl *

Col 2alias

Col 3title

Col 4description

longurl	alias	title	description
https://google.com	google	Google	Google search engine
https://github.com/recut	recut-github	Recut GitHub	Official Open Source & SDKs
https://twitter.com/recutinofficial	recut-x	Recut on X	Product Announcements & Releases
https://youtube.com/@recut	recut-yt	Recut YouTube	Video Tutorials & Demos
https://recut.in/blog/link-management	link-guide	Recut Blog	Ultimate Link Management Guide

Max 2048 MB

CSV Format & Column Structure. Four ordered columns to map your destinations, aliases, titles, and descriptions.

Column Position Rule: When creating the CSV file, you need to keep the header row, but the column names can be anything as long as their position is respected:longurl (Col 1) → alias (Col 2) → title (Col 3) → description (Col 4)

Column 1Required

longurl

The full destination web address you want to shorten. Must include the protocol (https:// or http://). Supports deep links, UTM tracking parameters, and query strings.

Example:https://google.com

Column 2Optional

alias

Your desired custom short slug (e.g. 'google' results in recut.in/google). If omitted or if the alias is already taken by another user, Recut automatically generates a unique random alias.

Example:google

Column 3Optional

title

A recognizable title for your link. Used inside your Recut dashboard for search, organization, and social preview cards.

Example:Google

Column 4Optional

description

Campaign notes, internal tags, or a brief explanation of the destination link for your team members.

Example:Google search engine

Sample File & Code Snippet. Copy the exact CSV text or download the pre-formatted starter template.

Raw CSV Structure

4 Positional Columns

Copy the standard CSV format with comma delimiters to paste into your spreadsheet or text editor.

sample-import-file.csv

longurl,alias,title,description
https://google.com,google,Google,Google search engine
https://github.com/recut,recut-github,Recut GitHub,Open Source & SDKs
https://twitter.com/recutinofficial,recut-x,Recut on X,Product Announcements
https://youtube.com/@recut,recut-yt,Recut YouTube,Video Tutorials
https://recut.in/blog/link-management,link-guide,Recut Blog,Ultimate Guide

Download Starter Template

.CSV Ready

Download the pre-formatted starter CSV file with headers in place. Ready to open in Excel, Google Sheets, or any plain text editor.

File Format.csv (Comma Separated)

Column Alignment4 Positional Columns

Upload LimitUp to 2048 MB

Import in Dashboard

Important Migration Rules. Key specifications regarding file size limits, deduplication, and background queues.

2 GB Limit

Max 2048 MB File Size

Your CSV file cannot be bigger than 2048 MB. This generous quota lets you migrate hundreds of thousands of links in a single file upload.

Async Queue

Background Processing for >100 Links

If your file contains more than 100 links, they are processed asynchronously in the background so your browser never freezes or times out.

Zero Duplicates

Automatic Deduplication

Duplicate links within the same upload file are automatically detected and ignored to keep your link dashboard clean.

Auto Fallback

Smart Alias Conflict Fallback

If a specified custom alias is already taken by another link, Recut automatically generates a clean random alias so your import never fails.

Links Only

Link Structure Only (No Past Stats)

This tool imports links, destinations, titles, and descriptions. It does not import historical click analytics or past visitor logs from external software.

Position Based

Header Row Position Matters

You must keep a header row in your CSV. Column header names can be anything as long as the 4 column positions (longurl, alias, title, description) are respected.

How to Import in 4 Simple Steps. A straightforward path from raw links to active Recut short URLs.

STEP 01

Format or Export Your CSV

Export your links from Bitly, Rebrandly, TinyURL, or a spreadsheet. Ensure the columns follow the 4-column order: longurl, alias, title, description.

STEP 02

Download the Official Template

Use our sample CSV file to verify header positioning and valid URLs before uploading.

Download Sample (.csv)

STEP 03

Upload via Recut Dashboard

STEP 04

Automated Provisioning

Recut parses all links instantly. Files with >100 links run smoothly in the background while you continue working.

Ready to import your link catalog?

Get Started for Free

Migrate From Any Platform. Easily transition your links from legacy shorteners and spreadsheets into Recut.

Bitly

Export your Bitly link inventory from Settings > Advanced > Export CSV. Reorder the columns to match Recut's 4-position format.

Rebrandly

Download your links report from Rebrandly. Map Destination URL to Column 1 and Custom Slash Tag to Column 2.

TinyURL

Export your TinyURL active links. Keep your custom aliases intact or let Recut generate new high-speed short URLs.

BL.INK & Short.io

Bulk export your team links into CSV and upload directly into Recut for high-throughput edge routing.

Google Sheets & Excel

Create a 4-column spreadsheet with longurl, alias, title, description, and save as comma-separated values (.csv).

WordPress & Custom CMS

Export redirection tables or affiliate plugins like Pretty Links and migrate thousands of URLs in seconds.

Frequently Asked Questions. Everything you need to know about CSV link import, batch files, and queues.

What is the required CSV structure for importing links?

The CSV must contain 4 positional columns: Column 1 is longurl (required destination URL), Column 2 is alias (optional short slug), Column 3 is title (optional link title), and Column 4 is description (optional notes). You must include a header row, although the header names themselves can be customized as long as the positional order is preserved.

What happens if a custom alias is already taken?

If a custom alias in your CSV file is already in use by another link, the Recut importer does not fail the row. Instead, it automatically generates a unique random alias for that link so your entire import batch succeeds without interruption.

Does the importer migrate past click statistics and historical analytics?

No. This tool imports links, destinations, aliases, titles, and descriptions. It does not import historical click logs or third-party analytics data from external tools. Once imported, Recut will track all new clicks in real time with comprehensive analytics.

What is the maximum CSV file size allowed?

CSV files can be up to 2048 MB (2 GB) in size. This generous limit allows enterprise marketing teams to migrate hundreds of thousands of links in a single operation.

How does background processing work for large files?

If your import file contains more than 100 links, Recut automatically queues the file for background processing. Your links are provisioned asynchronously so you do not have to keep your browser tab open while the migration completes.

How does Recut handle duplicate links in the CSV?

Duplicate destination links within the same CSV file are automatically detected and ignored. This prevents accidental duplicate short links from cluttering your dashboard.