> ## Documentation Index
> Fetch the complete documentation index at: https://dub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How to import links from a CSV file

> Easily import your links from a CSV file into Dub.

You can also import your existing links into Dub via our CSV import feature. This is useful if you have a large list of links to import or if you want to [import links from another provider](/help/article/migrating-from-bitly) that we don't have a 1-click importer for.

To import your links, you can follow these steps:

**1. Prepare your CSV file**

Before you import your CSV file, make sure it is in the correct format. Your CSV file needs to have the following data:

| Column | Required | Description | Example |
| - | - | - | - |
| Destination URL | **Yes** | The destination URL of the link you want to import. | `https://www.google​.com` |
| Short link | **Yes** | The shortened version of the link. | `yourdomain.com/abc123` |
| Title | No | The title of the link. | `Google` |
| Description | No | The description of the link. | `Search the web` |
| Tags | No | The tags of the link – must be a comma-separated list of tags. | `search, google, web` |
| Creation date | No | The date the link was created. | `2024-01-01` |

The actual names of your columns can be anything you want, but you need to make sure that the required columns are present.

**2. Upload your CSV file**

If you haven't already, [create a workspace on Dub](/help/article/what-is-a-workspace).

> [!NOTE]
>
> **Protip**: Once you create your workspace, we generally recommend you ***not
> to [configure your domain](/help/article/how-to-add-custom-domain)*** until
> you've migrated all your links. This will prevent any potential downtime for
> your links.

Then, from your [short links page](https://app.dub.co/links), click on the `⋮` button under the **Create Link** button and select **Import from CSV**.

![Import from CSV button](https://mintcdn.com/dub/HiK27QP5TPB3P_le/images/dub-links/links-dropdown.png?fit=max\&auto=format\&n=HiK27QP5TPB3P_le\&q=85\&s=fa1ae1e357674a2eb9398f4b61f5fd76)

This will open a modal with a file uploader.

![CSV import modal](https://mintcdn.com/dub/HiK27QP5TPB3P_le/images/dub-links/import-csv-modal.png?fit=max\&auto=format\&n=HiK27QP5TPB3P_le\&q=85\&s=8d0f730270038f5d39692dcc2a2369cf)

Upload your CSV file, and you should be automatically redirected to the next step.

**3. Review the AI-generated column mappings**

When you upload a CSV file, [Dub AI](https://dub.co/blog/introducing-dub-ai) will automatically map the columns in your CSV file to the [supported data fields in Dub](/docs/data-model#links).

![CSV import column mapping](https://mintcdn.com/dub/HiK27QP5TPB3P_le/images/dub-links/import-csv-modal-mapping.png?fit=max\&auto=format\&n=HiK27QP5TPB3P_le\&q=85\&s=e456be0cf1edbb60146524b3f24312ae)

You can then review and edit the mappings before selecting **Confirm import**. In just a few seconds, all your links will be migrated to Dub.

Alternatively, you can also select **Choose another file** to upload a different CSV file.

**4. Review the import summary**

Once all your links have been imported, we will send you an email to let you know that the migration is complete.

![Email notification about completed CSV import](https://assets.dub.co/help/csv-import-email.png)

If there are any issues with the import, we will send you a separate email with the details of the errors.

![Email notification about CSV import errors](https://assets.dub.co/help/csv-import-email-error.png)

**5. Configure your domain**

Once all your links are imported, you can [configure your domain](/help/article/how-to-add-custom-domain#step-2-configure-your-domain) by setting the right DNS records. Once this is done, you can start using your links!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.