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

# Importing Subscribers

> Bring your existing email subscribers into Onset from a CSV.

Imports live under **Settings → Workspace → Import**.

> [!NOTE]
>
> This page covers subscriber imports. To bring across your existing release notes from another tool, see [Importing release notes](https://onset.io/docs/guides/releases/import/overview.md).

## Import subscribers from a file

**1. Prepare your file**

A `.csv`, `.xls`, or `.xlsx` file with **no header row**, and **one email address per row**. Nothing else: no name column, no extra fields.

**2. Upload it**

Go to **Settings → Workspace → Import**, choose **CSV Subscriber Import**, and upload the file.

**3. Wait for the email**

The import runs in the background. Onset emails you when it's finished, so you don't need to keep the tab open.

Duplicate addresses are skipped rather than added twice, so re-running an import with overlapping data is safe.

> [!WARNING]
>
> Only import addresses that opted in to hear from you. Importing a purchased or scraped list will hurt your deliverability and may violate anti-spam laws in your customers' jurisdictions.

## Assigning imported subscribers to a list

The CSV import doesn't ask which [list](https://onset.io/docs/guides/subscribers/lists.md) to use. Imported subscribers land in your workspace and can be organized afterwards from **Audience → Subscribers**.

If you need subscribers placed on a specific list at creation time, use the [Subscribers API](https://onset.io/docs/developers/api-reference/introduction.md) instead.

## Other sources

Subscribers can also reach your workspace by subscribing on your public page, being added manually, or through the API. See [Subscribers overview](https://onset.io/docs/guides/subscribers/overview.md).


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