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

# Contacts and lists

> Where your contacts come from, what their consent means, and how lists and exports work.

A contact is one email address your store can email, and the person behind it. The **Contacts** screen shows them; your agent makes the changes.

## Where contacts come from

* **Shopify customers.** After install, the first pull brings in every Shopify customer with an email address, with their email consent. OpenEmail then stays in step with Shopify on its own, by webhook and a regular check for anything a webhook missed.
* **Checkouts.** A guest who gives an email at checkout becomes a contact. They're subscribed only if they ticked the marketing box.
* **A Klaviyo import.** Your profiles, consent and lists, brought over in one approved migration. See [Move from Klaviyo](https://openemail-docs.mintlify.site/use/move-from-klaviyo.md).
* **Hand subscribes.** People who agreed to your email outside Shopify, such as on a paper form at a market stall. You enter them yourself (step 3 below).

A Shopify customer, a guest checkout and a Klaviyo profile with the same address are one contact. Plus tags are kept: `ana+shop@example.com` and `ana@example.com` are two contacts.

## What consent means

Each contact has an email consent, shown as the counts at the top of **Contacts**:

* **Subscribed**: they agreed to receive marketing email. Only subscribed contacts get campaigns and flows.
* **Not subscribed**: no agreement is in place. They may never have said yes, or not confirmed yet.
* **Unsubscribed**: they asked not to get marketing email. An unsubscribe here is written back to their Shopify customer.

Consent isn't the only check. The do-not-email list can still stop email to a subscribed contact, for example after a bounce or a complaint, and OpenEmail checks both each time it hands an email to your sender. See [Unsubscribes and the do-not-email list](https://openemail-docs.mintlify.site/use/unsubscribes-and-do-not-email.md).

Tracking consent is separate: whether a contact allows OpenEmail to record their opens and clicks. Only **Declined tracking** stops the recording, and it never changes who gets email.

> [!NOTE]
>
> **Your agent can't subscribe anyone.** A contact becomes subscribed only through Shopify, a ticked box at checkout, an approved Klaviyo migration, or a hand subscribe a staff member approves.

**1. Find a contact**

* Open **Contacts**. The table lists contacts by when they last engaged (their last order, opt-in or real click), most recent first.
* Search for a name or one full email address. An address also finds the same address with any plus tag. Use the **Email consent** filter to see one group.
* Select a contact to open their page: **Consent history** (who changed what, and when), **Do-not-email entries**, **Lists**, and **Details**, with where they came from and a link to their Shopify customer.

```text Ask your agent wrap theme={"dark"}
Look up ana@example.com. Tell me her email consent, where she came from, and which lists she's on.
```

> [!TIP]
>
> **Checkpoint:** the contact's badges show the consent you expected.

![A contact page: consent history, do-not-email entries, lists, and details such as where the contact came from.](https://mintcdn.com/openemail-docs/OnJRIGCNyk9zxe6d/images/use/contact-page.png?fit=max\&auto=format\&n=OnJRIGCNyk9zxe6d\&q=85\&s=ad4efbdad90f208324d26356dd9b2eb7)

**2. Make a list**

* A list is a fixed set of contacts a campaign goes to. **All contacts** is every contact and always comes first. Every other list is one your agent made or the Klaviyo import brought over.
* Open the **Lists** tab on **Contacts** to see each list's **Members** and how many are **Subscribed**. Select a list to see its members.
* Your agent creates, renames and deletes lists, and adds or removes contacts. A list a campaign uses can't be deleted.

```text Ask your agent wrap theme={"dark"}
Make a list called Launch guests and add the contacts I name: ana@example.com, ben@example.com.
```

> [!TIP]
>
> **Checkpoint:** the list shows under **Lists** with the member count you expected.

> [!NOTE]
>
> **Lists don't update themselves.** There are no rule-based segments: a list changes only when your agent edits it. Klaviyo segments arrive as fixed lists, named after the segment with "from Klaviyo" and the date of the read.

**3. Add people who agreed in person**

* On **Contacts**, choose **Hand subscribe**.
* Fill in the **Statement** (how and where they agreed, up to 2,000 characters, with no email addresses), **Date they agreed** and **Time they agreed** (in your store's time zone, never in the future), and **Email addresses** (up to 100).
* **Subscribe addresses** opens a review of exactly what will happen. Confirming it is your approval, recorded with your staff account.
* An address with a hard bounce or a complaint stays blocked; a hand subscribe never lifts it. Nothing is written back to Shopify, and no address can be added afterwards: make another hand subscribe instead.

```text Ask your agent wrap theme={"dark"}
Prepare a hand subscribe for these addresses. They signed our paper form at the market stall on Saturday at 2:30 pm: ana@example.com, ben@example.com. Send me the approval link.
```

> [!TIP]
>
> **Checkpoint:** each address shows as subscribed, and its consent history shows your statement.

**4. Export**

* **Everyone or one list:** ask your agent for a CSV. It returns a file link when the export finishes; open it in the Shopify admin. The CSV holds contact IDs, email addresses, names, email consent, tracking consent and Shopify customer IDs.
* **One person:** on their contact page, choose **Export** for a JSON file of everything OpenEmail holds on them. Your agent can do the same, by contact or by address.
* File links expire 24 hours after the file is made.

```text Ask your agent wrap theme={"dark"}
Export the Launch guests list as a CSV and give me the download link.
```

> [!TIP]
>
> **Checkpoint:** the file page shows the file as ready, and **Download** saves it.

> [!TIP]
>
> **Cells that start with `=`, `+`, `-` or `@` get a leading apostrophe** in every CSV, so a spreadsheet never runs them as formulas. The apostrophe is part of the value.

> [!WARNING]
>
> **Erase contact can't be undone.** It deletes the contact and their history, and only a staff member signed in to the Shopify admin can do it; your agent can't. Their do-not-email entries stay as a hash, so a block still applies. See [What stays with you](https://openemail-docs.mintlify.site/ai/what-stays-with-you.md).

Next, send a list its first email: [Campaigns](https://openemail-docs.mintlify.site/use/campaigns.md).


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