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

# Customer Groups

> Put customers into groups, like VIP buyers or wholesale, and send a campaign to just that group.

Groups let you send the right message to the right people. A **group** organizes customers the way your business works. For example, you can create groups for VIP Customers, Newsletter Subscribers, or Retail Customers. A contact can be added to multiple groups and selected whenever you send a [campaign](https://docs.chatflows.io/messaging/campaigns.md).

## Where groups show up

* **Campaigns** — when creating a campaign, choose a group as your audience and everyone in it receives the message.
* **Customers page** — filter your list by group, or select many contacts and add them all to a group in one go. See [Bulk Actions & Merge](https://docs.chatflows.io/contacts/bulk-actions-and-merge.md).
* **Contact details** — a contact's groups appear in their details panel.
* **New contacts from messages** — when a message from a new person creates a contact, you can have them placed into groups for you. Set them in [Settings → Customers](https://docs.chatflows.io/settings/contact-configuration.md).

## Creating a group

![New Group form showing fields for name, description, and color](https://docs.chatflows.io/core-setup/img/group-form.png)

Image shows the New Group form.

**1. Open Customer Groups**

Click **Setup** in the sidebar, then **Customer Groups**.

**2. Click Add Group**

The button sits at the top right of the page. A form opens on the right side of the screen.

**3. Fill in the details**

* **Name** — a clear group name, such as **VIP Customers** or **Newsletter Subscribers**. Each name can be used only once.
* **Description** — optionally note who belongs in this group, so your team adds the right people.
* **Color** — the badge color shown wherever the group appears. Click the swatch to pick one, or type a color code.

**4. Save**

Click **Save**. The group is created and ready to receive contacts.

> [!TIP]
>
> You can also create a group without leaving the contact form — click the `+` icon beside the **Groups** field while adding or editing a contact.

## Adding contacts to a group

* **When creating or editing a contact** — pick one or more groups in the **Groups** field of the contact form.
* **In bulk** — on the **Customers** page, select multiple contacts and add them all to a group at once. See [Bulk Actions & Merge](https://docs.chatflows.io/contacts/bulk-actions-and-merge.md).
* **Automatically** — have contacts created from incoming messages placed into a group. Set it in [Settings → Customers](https://docs.chatflows.io/settings/contact-configuration.md).

## Managing groups

![Customer Groups table showing a group with its name, description, color dot, contact count, and a row menu with Edit and Delete](https://docs.chatflows.io/core-setup/img/group-table.png)

Image shows the Customer Groups table with a row menu open.

From the **Customer Groups** page you can:

* The **Contacts** column shows how many contacts are in each group.
* **Edit** — click the menu icon at the end of a row and click **Edit** to change the name, description, or color.
* **Delete** — click the menu icon and click **Delete**.

> [!NOTE]
>
> A group that's still in use can't be deleted. If any contacts are in it, or it's chosen as a default in [Settings → Customers](https://docs.chatflows.io/settings/contact-configuration.md), ChatFlows tells you where it's used — clear it there first, then delete.

## What's next

> [card] [Customer Statuses](https://docs.chatflows.io/core-setup/statuses.md)
>
> Track where every contact stands in your sales journey.

> [card] [Customer Tags](https://docs.chatflows.io/core-setup/labels.md)
>
> Add colored labels to make important contacts easy to identify.


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