> For the complete documentation index, see [llms.txt](https://distance.gitbook.io/distance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://distance.gitbook.io/distance/getting-started/contacts/lists-and-segments.md).

# Lists & Segments

Lists & segments help your team organize contacts for targeted outreach, filtering, and automation workflows in Distance.

### **Introduction**

The **Lists & Segments** feature allows you to group contacts either manually or dynamically using rules and conditions. This helps your team organize audiences for SMS campaigns, follow-ups, automations, and customer management.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FwyfzYQ8pwezcR2YL6jJy%2Fimage.png?alt=media&amp;token=a15cc26a-151a-44d2-8b3a-68ddaf0c4c2d" alt=""><figcaption></figcaption></figure></div>

**Lists** are static groups where contacts are manually selected, while **Segments** automatically update based on configured conditions. Together, they help ensure the right contacts are always included as your customer data grows and changes.

***

### **Accessing Lists & Segments**

Navigate to **Contacts**, then click the **Lists & Segments** tab.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F8nYOBzjpV9oopjSq5Zrk%2Fimage.png?alt=media&amp;token=df37f39d-667e-446a-a488-3e9cac4c2ae1" alt=""><figcaption></figcaption></figure></div>

The **Lists & Segments** page displays all created lists and segments in your account.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FOJjjD22CQ5mRyrunjtY5%2Fimage.png?alt=media&amp;token=9444c9ef-3c5d-4438-a57f-40eac59d9fcc" alt=""><figcaption></figcaption></figure></div>

Available columns include:

* **Name**
* **Type**
* **Contacts**
* **Created**
* **Edit** button

You can also use the filter dropdown to display only lists or only segments.

***

### **Creating a list or segment**

Click **Create** to open the **Create new** window.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FepQLIZtDiy0Y8JoEKiYm%2Fimage.png?alt=media&amp;token=fdb431d7-72fb-457c-974c-f6cbff3e934b" alt=""><figcaption></figcaption></figure></div>

Choose what you would like to create:

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FHHIZNE5RiMcRSphDJSYd%2Fimage.png?alt=media&amp;token=721664ce-af2a-4742-af9c-0fe79fa335ad" alt=""><figcaption></figcaption></figure></div>

* **Segment** - Create a dynamic segment using conditions or rules
* **List** - Manually select specific contacts to create a list

Enter the **Segment name** or **List name** depending on the selected type.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FQHYts38feyCQfB1zGou8%2F1.jpg?alt=media&amp;token=d7e1833e-a2f2-407c-80aa-3141507abda5" alt=""><figcaption></figcaption></figure></div>

Click **Create** to continue.

***

### **Understanding segments**

Segments automatically update based on the conditions you configure. Contacts are added or removed dynamically as their information changes and matches the configured rules.

After creating a segment, the page displays two tabs: [**Members**](#members-tab) and [**Conditions**](#conditions-tab).

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FRjOlrrY3WEsUIrweyi2x%2Fimage.png?alt=media&amp;token=b9b65c60-02af-4a48-9867-3f85e7d1ee68" alt=""><figcaption></figcaption></figure></div>

#### **Members tab**

The **Members** tab displays all contacts currently included in the segment based on the active conditions.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FMJtdCXiJ8xaCfLkkOCpi%2Fimage.png?alt=media&amp;token=f57722db-88a1-4847-86ad-c05301cd307e" alt=""><figcaption></figcaption></figure></div>

When a segment is first created without any conditions applied, all contacts are displayed by default.

The tab label displays the current number of matching contacts, such as "**5 Members**". The number of contacts is also indicated under the **Segment** name.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F6uCwCFK5Mitw4LMIBzgw%2Fimage.png?alt=media&amp;token=c1e45efb-9350-47fb-8e45-24b4d74c090d" alt=""><figcaption></figcaption></figure></div>

The table displays the following information:

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FD3IlclQkJV2VwxpXzi4v%2Fimage.png?alt=media&amp;token=7a4b46c3-c243-4bed-91f7-98d0e6bcd631" alt=""><figcaption></figcaption></figure></div>

* **Name**
* **Email**
* **Phone**
* **Date added**

You can also click the **information icon** beside a contact to open that contact’s information page.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FThpmU6JLypPo8p6MoRGu%2Fimage.png?alt=media&amp;token=479189fa-7652-4f97-b996-ea4ca104bd5f" alt=""><figcaption></figcaption></figure></div>

#### **Conditions tab**

The **Conditions** tab is where you configure the rules used to build the segment.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F1R9ny0UnDh3StIIv3boJ%2Fimage.png?alt=media&amp;token=437dcc95-4a4b-4cb6-9123-a7f691cfa64b" alt=""><figcaption></figcaption></figure></div>

Click **+** **Add condition** to create a filtering rule.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FV4DiYr5AQcNFmQgqvUSK%2Fimage.png?alt=media&amp;token=218126a2-6875-4f2e-b4d2-8d07b7ac4c78" alt=""><figcaption></figcaption></figure></div>

Below this, you can set how conditions are evaluated using **Include contacts who match**, with a dropdown for **All (AND)** and **Any (OR)**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FkUfkzWOaQajk682TufEq%2Fimage.png?alt=media&amp;token=4dd40180-8936-4866-8d9d-b5adc7624c1c" alt=""><figcaption></figcaption></figure></div>

Each condition is made up of two dropdowns:

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FsS8XUcDySTfp3Nb5YFOV%2Fimage.png?alt=media&amp;token=20535277-1897-4452-be0f-509ad9d94bb1" alt=""><figcaption></figcaption></figure></div>

* The left dropdown to select a contact field or custom property
* The right dropdown to select the operator

Available operators change based on the selected field or property type. For [**Custom properties**](/distance/getting-started/settings/custom-properties.md#custom-properties), operators depend on the **Property type**. For more details, see [**Property type**](/distance/getting-started/settings/custom-properties.md#property-type) in [**Settings**](/distance/getting-started/settings.md).

* **Text**
* **Number**
* **Date & Time**
* **Dropdown**

***

### **Condition preview**

The **Condition preview** section shows a summary of how your segment rules will behave as you build them.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F1lspeFAu09rFGwEvct4K%2Fimage.png?alt=media&amp;token=b9de6a27-c803-41b0-8d10-3a1532b1952b" alt=""><figcaption></figcaption></figure></div>

This section displays a readable summary of the configured conditions and an estimated number of matching contacts.

After reviewing your rules, click **Apply condition** to update the segment membership preview and apply the filtering logic.

***

### **Understanding lists**

**Lists** are manually managed groups of contacts and do not update automatically based on conditions.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F8N5cuD38wHMg1wvWd4v4%2Fimage.png?alt=media&amp;token=f316a35c-a747-4ed6-ab7a-07fbc8360de0" alt=""><figcaption></figcaption></figure></div>

Unlike segments, lists give your team full control over which contacts are included, making them useful for curated audiences, one-time outreach, or specific campaign groups.

Each list can be managed with the available action buttons:

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FWZRnh9ZoZF2JjzbcZv4T%2Fimage.png?alt=media&amp;token=61934226-a26f-4387-9eb1-6a4155c72255" alt=""><figcaption></figcaption></figure></div>

* **Rename** – Update the list name.
* **Delete** – Remove the list.
* **+ Add contacts** – Open the contact selector to manage list members.

When you click **+ Add contacts**, the **Add contacts to the list** window opens.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FLAq5MDl8bQiwXl2LZPy5%2Fimage.png?alt=media&amp;token=64fa4f38-5222-4008-8746-2e4cc9c50c66" alt=""><figcaption></figcaption></figure></div>

From here, you can select multiple contacts to add them to the list. Contacts that are already included can also be unchecked to remove them from the list.

Click **Update list** to save your changes or **Cancel** to close the window.
