# Lists

Source: https://kirora.io/docs/guides/contacts/lists

Create and manage the contact lists you keep yourself for newsletters, clients or members, and use them in campaigns.

A list holds the contacts you choose, such as newsletter subscribers, clients or members. People join by hand, by import, through a form, from a journey or from your app through the [API](https://kirora.io/docs/api/reference/identifyContact), and stay in the list until you or an automation removes them.

If you want an audience that updates itself from rules, such as "ordered in the last 30 days", use a [segment](https://kirora.io/docs/guides/contacts/segments) instead.

## Create a list

1. Go to **Lists** and choose **New list**.
2. Enter a **List name**, such as *Supper club*.
3. Optionally, add a **Description** so teammates pick the right audience.
4. Choose **Create list**.

You can also create a list on the spot while importing contacts or choosing a campaign's audience.

## Add contacts to a list

There are several ways in:

- **From the list's page:** choose **Add members**, search by name or email, select contacts across pages and add them.
- **From Contacts:** select contacts, then choose **Add to list** from the actions bar. To include everyone who matches your search or filters, not just this page, choose **Select all matching** first.
- **During an import:** use **Add successful contacts to a list** to put everyone in one list, or map a **Lists** column to add each contact to the lists their row names. See [Add contacts to lists from a column](https://kirora.io/docs/guides/contacts/import-contacts#add-contacts-to-lists-from-a-column).
- **From a signup form:** forms can add everyone who signs up to one or more lists.
- **From a journey:** an **Action** step can add contacts to a list or remove them from one. See [Build a journey](https://kirora.io/docs/guides/journeys/build-a-journey).

Adding someone who's already in the list does nothing, so you can't create duplicates.

> **Note:** Adding a contact to a list doesn't give consent. A campaign sent to a list only reaches members who have agreed to that channel and aren't suppressed. The members table shows each person's **Email consent**.

## Remove contacts from a list

- On the list's page, choose **Remove** on a member's row, then **Remove from list**.
- On **Contacts**, select contacts and choose **Remove from list**. Removing in bulk is limited to admins and the owner.

Removing someone from a list only ends that membership. The contact, their consent and their other lists are kept.

## Use a list

- **As a campaign audience.** On a campaign's **Audience** step, choose **Lists** and add one or more lists. Someone in several gets the campaign once. See [Create a campaign](https://kirora.io/docs/guides/campaigns/create-a-campaign).
- **In a segment.** Add a **List membership** condition, for example to include everyone in *Supper club* or to leave out *Staff*.
- **To start a journey.** Use the **Joins a list** trigger, for example to welcome new *Newsletter* members. See [How journeys work](https://kirora.io/docs/guides/journeys/how-journeys-work).
- **To filter contacts.** On **Contacts**, filter by list, or [export](https://kirora.io/docs/guides/contacts/manage-contacts#export-contacts) a list's members (admins and the owner).

## See what uses a list

When you choose **Delete** on a list's page, the confirmation shows what uses it, under **Segments**, **Campaigns**, **Journeys**, **Goals**, **Templates**, **Shared blocks** and **Forms**, or *Nothing else uses this list.* Choose **Cancel** there if you only wanted to check.

## Delete a list

On the list's page, choose **Delete**, then **Delete list** to confirm. The list and its memberships are removed, but the contacts and their consent are kept.

You can't delete a list while any of these use it:

- an unfinished campaign (draft, scheduled, sending or testing)
- an active or paused journey
- a segment
- a goal that isn't retired
- a template or shared block with a block shown only to, or hidden from, the list's members (an unfinished campaign's content counts too)
- a published form that adds people to the list or offers it in a field. [Unpublish or delete the form](https://kirora.io/docs/guides/forms/create-a-signup-form#publish-and-share) first.

If something still blocks it when you confirm, the delete is refused and the confirmation lists only what blocks it. Sent or cancelled campaigns, draft or archived forms, retired goals and draft or ended journeys don't block it, but update any that mention the list. An archived form whose list is deleted comes back as a draft when you unarchive it.

## Lists and test lists

A test list isn't a contact list. Test lists hold teammates you send test emails to, and never receive real campaigns. See [Test and preview a campaign](https://kirora.io/docs/guides/campaigns/test-and-preview).