> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-cb-notifylyst.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import sign-ups

> Bring an existing waiting list over from another app or a spreadsheet.

**Settings → Import sign-ups.** Upload a CSV and each row becomes a sign-up, exactly as if the
shopper had used the form on your storefront.

![Settings → Import sign-ups with the CSV drop zone, the Choose file button and the table of expected columns.](https://mintcdn.com/codebeans-cb-notifylyst/helB_Y1ZQRw5r3Uo/images/app-15-import.png?fit=max\&auto=format\&n=helB_Y1ZQRw5r3Uo\&q=85\&s=3b513219c7a1fab5d3d7c41e3e714760)

> [!NOTE]
>
> **Nothing is sent during the import.** Imported shoppers wait for the next restock like any other
> sign-up — they are alerted the next time Shopify reports new stock for their variant.

## The file

CSV only, up to **5 MB** and **5,000 rows**. Keep the header row; columns can be in any order.
**Download sample CSV** gives you a file to start from.

| Column | Needed | Example | Notes |
| - | - | - | - |
| `variant_id` | **Required** | `9876543210` | The Shopify variant the shopper is waiting for. |
| `email` | Email **or** phone | `customer@example.com` | Becomes an email sign-up. |
| `phone` | Email **or** phone | `14155552671` | Digits with the country code, no `+` sign. Becomes an SMS sign-up. |
| `product_id` | Optional | `1234567890` | Checked against the variant when included. |
| `created_at` | Optional | `2024-01-15 10:30:00` | `YYYY-MM-DD HH:MM:SS`. |

Every imported sign-up asks for a quantity of 1 and uses English. Web push and WhatsApp sign-ups
can't be imported; SMS rows need SMS to be active on your store.

## Importing

1. Prepare the CSV.
2. Drop it on the page, or press **Choose file**.
3. Read the summary. Rows that don't fit are skipped and listed with the reason — for example the
   variant doesn't exist in this store, SMS isn't active, or that shopper is already signed up and
   waiting.

The new sign-ups appear in **Analytics → Sign-ups**.

> [!WARNING]
>
> **An import can't be undone in one step.** Check the file before you upload it — especially the
> variant IDs.

## Problems

| Message | Fix |
| - | - |
| **That isn't a CSV file…** | Save the sheet as CSV (comma separated) and upload again. |
| **That file is over 5 MB…** / **At most 5,000 rows per file…** | Split it into smaller files. |
| **The CSV needs a header row with at least variant\_id and an email or phone column…** | Add or rename the header row. |

To add a single sign-up by hand instead, use **Add sign-up** on the **Analytics** page — see
[Read your analytics](https://codebeans-cb-notifylyst.mintlify.site/app/guides/read-your-analytics.md#add-a-sign-up-by-hand).

> [card] [Guides](https://codebeans-cb-notifylyst.mintlify.site/app/guides/overview.md)
>
> Setup is done. Next: the day-to-day work.


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