> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onset.io/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](/guides/releases/import).
</Note>

## Import subscribers from a file

<Steps>
  <Step title="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.
  </Step>

  <Step title="Upload it">
    Go to **Settings → Workspace → Import**, choose **CSV Subscriber Import**, and upload the file.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.
</Warning>

## Assigning imported subscribers to a list

The CSV import doesn't ask which [list](/guides/subscribers/lists) 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](/developers/api-reference/introduction) 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](/guides/subscribers/overview).