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

# Lists

> Create a list, choose its preferred channels, add and remove contacts, and understand what the Subscribers figure counts.

export const Screenshot = ({id, src, srcDark, alt, caption}) => {
  if (!src) {
    return <Placeholder id={id} kind="screenshot" label="Screenshot coming soon" description={alt} icon={<ImageIcon />} />;
  }
  return <figure className="brd-media" data-media-id={id}>
      <img className="brd-media-frame block dark:hidden" src={src} alt={alt} />
      <img className="brd-media-frame hidden dark:block" src={srcDark || src} alt={alt} />
      {caption && <figcaption className="brd-media-caption">{caption}</figcaption>}
    </figure>;
};

A list is a group of contacts you add by hand, by import or through a signup form. Send a campaign to
a list and everyone subscribed to it is in the audience.

<Screenshot id="ss-contacts-lists-hero" alt="The Lists page showing three lists with their Subscribers counts and preferred channels" />

<Info>
  **Before you start:** go to **Contacts > Lists**. You need at least one contact to put in a list —
  see [Add and edit contacts](/contacts/add-and-edit-contacts) or
  [Import contacts](/contacts/importing).
</Info>

## List or segment

Both group contacts, but they answer different questions. A list is something a person belongs to and
can leave. A segment is a query over the data you hold.

|                      | List                           | Segment                                    |
| -------------------- | ------------------------------ | ------------------------------------------ |
| **Who's in it**      | Contacts you or a form added   | Contacts that match rules, or a frozen set |
| **People can leave** | Yes, by unsubscribing          | No; a segment has no subscription          |
| **Best for**         | Audiences people signed up for | Slicing your contacts by data              |

Use a list for an audience people opted into, and a [segment](/contacts/segments) to slice your
contacts by the data on them.

## Create a list

<Steps>
  <Step title="Open the Lists page">
    Go to **Contacts > Lists** and select **Create List**.
  </Step>

  <Step title="Name it">
    Enter a **List Name** and, if it helps your team, a **Description**.
  </Step>

  <Step title="Choose the preferred channels">
    **Preferred Channels** records which channels the list is meant for, such as email only, or email
    and SMS. It documents the list's purpose for your team and is shown on the list's page. It
    doesn't stop a campaign from using the list on another channel — who a campaign actually reaches
    is decided by each contact's channel identities.

    <Screenshot id="ss-contacts-lists-01-create" alt="The Create List dialog with List Name, Description and Preferred Channels filled in" />
  </Step>

  <Step title="Save">
    Select **Create**. The list appears in the table with a **Subscribers** count of zero.
  </Step>
</Steps>

## Add contacts to a list

* **From the contacts table.** Tick the contacts you want, then select **Add to List** and pick the
  list. Contacts already subscribed are left as they are.
* **On a single contact.** Open the contact and use the **Lists** section. See
  [Add and edit contacts](/contacts/add-and-edit-contacts).
* **On import.** Choose a list while importing a CSV. See [Import contacts](/contacts/importing).
* **Through a form.** A signup form always feeds exactly one list. See [Forms](/forms/overview).

## What Subscribers counts

A list's **Subscribers** figure counts the contacts subscribed to it right now. Two groups are not
counted:

* Contacts who unsubscribed from the list.
* People who signed up through a double opt-in form but haven't confirmed yet.

So a form can have more submissions than its list has subscribers. That gap is the unconfirmed ones.

## Remove someone from a list

Removing a contact from a list sets that membership to **Unsubscribed**. The contact itself, and
their membership of every other list, is untouched.

<Note>
  Unsubscribing from a list is not the same as suppression. A suppressed address is blocked across
  your whole organization, on every list. See
  [Suppressions and unsubscribes](/contacts/suppressions).
</Note>

## Delete a list

Select **⋮** on the list's row, then **Delete**. Two rules limit this:

* A list a signup form has used can't be deleted. Delete or repoint the form first.
* A signup form can only be published while the list it feeds is **Active**.

Deleting a list removes the memberships, not the contacts.

## Related

<Columns cols={2}>
  <Card title="Segments" icon="filter" href="/contacts/segments">
    Group contacts by rules instead of by subscription.
  </Card>

  <Card title="Import contacts" icon="download" href="/contacts/importing">
    Bring an audience in from a CSV and put it straight into a list.
  </Card>

  <Card title="Forms" icon="clipboard-list" href="/forms/overview">
    Let people subscribe themselves to a list.
  </Card>

  <Card title="Create a campaign" icon="send" href="/campaigns/create-a-campaign">
    Send to a list, a segment, or both.
  </Card>
</Columns>
