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

# Bulk import

> Create up to 1,000 short links at once from a CSV file or a pasted list of URLs.

Bulk import lets you create many short links in one go. Upload a CSV file or paste a list of URLs, check the preview, and confirm. URLdn creates every valid link and shows you a report for each row.

## Import your links

**1. Open Bulk Import**

Go to **Dashboard > Links > Bulk Import**.

**2. Add your URLs**

Drop a CSV file into the upload area, or paste URLs into **Paste URLs (one per line)**. Files can be up to 2 MB.

**3. Choose a default domain**

Under **Default Domain**, pick the domain for rows that do not name one. Leave it on **Default (urldn.com)** if you have not connected a custom domain.

**4. Check the preview**

Review the URL, alias, and domain for each row. Choose **Go back** to fix anything.

**5. Confirm the import**

Choose **Confirm Import**. The results table shows each line as **Created**, **Skipped**, or **Failed**, with a reason and the new short code.

## CSV format

Download the template from the Bulk Import page, or build a file with these columns:

```csv theme={null}
url,alias,title,domain
https://example.com/page,my-link,My Page Title,
https://another.example.com,,Another Link,
```

| Column | Required | What it does |
| - | - | - |
| `url` | Yes | The destination page. |
| `alias` | No | Your custom back-half. Leave blank to get a random 6-character code. |
| `title` | No | A name to help you find the link later. |
| `domain` | No | A verified custom domain you own, such as `go.example.com`. Leave blank to use the default domain. |

When you paste URLs instead of uploading a file, each line becomes one link with a random code.

## Rules for each row

* **Aliases** can use letters, numbers, `-`, and `_`, and must be 3 to 40 characters.
* **Reserved words** such as `api`, `dashboard`, `login`, `pricing`, and `bio` cannot be used as aliases.
* **Custom domains** in the `domain` column must be verified in your account and need a paid plan.
* **Duplicates** in the same file are skipped, so you do not create the same link twice.

## Limits

* Up to **1,000 rows** per import.
* Files up to **2 MB**, in `.csv` format.
* New links still count toward your plan's link limit. If you run out partway through, the remaining rows are skipped and the results tell you why.

> [!TIP]
>
> Importing the same file twice by accident is safe. URLdn recognizes a repeated import and returns the earlier results instead of creating duplicates.

> [card] [Shorten a few links without an account](https://docs.urldn.com/free-tools.md)
>
> The free Bulk Shortener tool handles small batches with no sign-in.


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