# Group contacts into segments

Group contacts into a named segment and see which of them can get marketing email.

Audience: dealer-staff
Availability: available
Canonical source: https://rooftoprv.com/docs/group-contacts-into-segments

A segment is a named group of contacts, such as show visitors or storage customers. You can send an email campaign to one or more segments instead of your whole mailing list.

A segment only groups contacts. It doesn't give you permission to email them.

## Before you start

- To open **Marketing** > **Segments**, you need the **View segments** permission.
- To change anything, you need the **Create segments** permission. That covers creating, editing, and deleting a segment, and adding or removing contacts. It also covers changing an existing contact's segments in **CRM**.

## Create a segment

Each segment needs its own name. Names that differ only by capital letters or punctuation count as the same name.

1. Go to **Marketing** > **Segments**.
2. Select **Create segment**. If you have no segments yet, the button reads **Create first segment**.
3. Enter a **Name**, such as VIP customers.
4. Optional: enter a **Description**.
5. Optional: choose a **Color**.
   The color is the dot next to the segment's name.
6. Select **Create**.
   The segment appears in the list with 0 in the **Contacts** column.

## Add contacts to a segment

1. In the list, select the segment's name.
2. Select **Add contacts**.
3. In **Search existing contacts**, enter at least two characters of a name or email address.
   Contacts already in the segment are left out of the results.
4. Select **Add** next to the contact.
5. Repeat for each contact.
6. Select **Done**.

To add someone who isn't a contact yet:

1. Select **Create new contact** in the same panel.
2. Enter **First name**.
3. Enter **Last name**.
4. Enter **Email**.
5. Select **Create & add**.
   The new contact is not subscribed to your mailing list.

Contacts also join segments in other places:

- When your team adds or edits a contact in **CRM**, the **Segments** field under **Mailing list** sets the contact's segments. The field shows once you have at least one segment.
- A lead type can add contacts to segments when a website form creates a lead of that type. See [Set up lead types](https://rooftoprv.com/docs/set-up-lead-types).

## Check who can get marketing email

Open a segment. The four cards at the top count its contacts:

| Card | What it counts |
|---|---|
| **Segment members** | Everyone in the segment |
| **Marketing eligible** | Contacts who can get marketing email now |
| **Cannot send now** | Contacts who are blocked or on hold |
| **Needs review** | Contacts whose status couldn't be confirmed |

Under **Audience preview**, each contact has two columns to read:

- **Why included** says how the contact joined the segment.
- **Marketing eligibility** shows **Eligible**, **Not eligible**, **Deferred**, or **Review**. A short reason shows under it, such as **Marketing turned off** or **Missing or invalid email**.

The page lists the first 100 contacts. For a larger segment, a note under the table says the card counts are a preview, not the full segment.

## Remove a contact from a segment

1. Open the segment.
2. In the contact's row, select the remove button, labeled **Remove from segment**.
   The contact leaves the segment right away. The contact itself is not deleted.

## Edit or delete a segment

> **Warning:** Deleting a segment removes it from every contact in it. There is no restore button.

To edit a segment:

1. Select the edit button (**Edit segment**) in its row. Or open the segment and select **Edit**.
2. Change the name, description, or color.
3. Select **Save changes**.

To delete a segment:

1. In the list, select the delete button in the segment's row, labeled **Delete segment**. Or open the segment and select **Delete**.
2. Check the name and the number of contacts in the message.
3. Select **Delete**.
   The segment leaves the list. The contacts stay in your CRM.

## What happens next

Use the segment as a campaign audience. In a campaign's **Audience** step, choose **Filtered subscribers**. Then choose the segment under **Segments**. See [Create an email campaign](https://rooftoprv.com/docs/create-an-email-campaign).

A campaign still starts from your mailing list. A contact in the segment who isn't eligible for marketing email doesn't get the campaign.

## Troubleshooting

**A change fails with an error**
You need the **Create segments** permission. The buttons show without it, but the change fails.

**The dialog shows an error and the segment isn't created**
The name is taken. Names that differ only by capital letters or punctuation count as the same name.

**I can't create a segment with a name I used before**
A deleted segment keeps its original name reserved, and so does a segment you renamed. Choose a different name for the new one.

**Create & add shows "Failed to create contact"**
A contact with that email address may already exist. Search for them under **Search existing contacts** and select **Add** instead.

**A contact is in the segment but shows Not eligible**
Being in a segment doesn't subscribe a contact. Read the reason under the badge. **No affirmative permission** means no marketing permission is on record for the contact. **Marketing turned off** means marketing email is turned off for them.

**The search shows "All matching contacts already in segment"**
Every contact that matches your search is already a member. Try another name or email address.

## Related guides

- [Create an email campaign](https://rooftoprv.com/docs/create-an-email-campaign)
- [Set up lead types](https://rooftoprv.com/docs/set-up-lead-types)
