> ## 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 Statuses

> Track where each customer stands, from New to Closed, using ready-made stages or your own.

ChatFlows starts you off with five ready-made statuses — **New**, **In Progress**, **Contacted**, **Qualified**, and **Closed** — with **New** set as the default. Rename them, recolor them, or replace them with stages that match how your business actually works.

## Where statuses show up

Once set, a status follows the contact everywhere:

* **Customers page** — each contact shows their status as a colored badge, and you can filter the list by status.
* **Inbox** — the sidebar lets you filter conversations by contact status, with a count next to each one.
* **Campaigns** — when picking who receives a [campaign](https://docs.chatflows.io/messaging/campaigns.md), you can filter the audience by status.
* **Exports** — filter by status before exporting to download just that slice of your list. See [Import & Export](https://docs.chatflows.io/contacts/import-export.md).
* **New contacts from messages** — when someone messages you first, ChatFlows creates the contact automatically and gives them your chosen default status. You can change these defaults in [Settings → Customers](https://docs.chatflows.io/settings/contact-configuration.md).

## Creating a status

![New Status form showing fields for name, color, sort order, and a default status switch](https://docs.chatflows.io/core-setup/img/status-form.png)

Image shows the New Status form.

**1. Open Customer Statuses**

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

**2. Click Add Status**

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 stage name, such as **New Lead**, **Quoted**, or **Won**. Required, and each name can be used only once.
* **Color** — the badge color shown wherever the status appears. Click the swatch to pick one, or type a color code. Leave it empty and ChatFlows picks a color for you.
* **Sort Order** — the position of this status in lists. It's pre-filled with the next spot, so you can usually leave it as is.
* **Default status** — turn this on to give this status to every new contact automatically. Only one status can be the default, so turning it on here turns it off on the previous one.

**4. Save**

Click **Save**. The status is ready to use right away in contact forms, filters, chat, and campaigns.

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

## Managing statuses

![Customer Statuses table listing New, In Progress, Contacted, Qualified, and Closed with color dots, order numbers, a default switch on New, and a row actions menu](https://docs.chatflows.io/core-setup/img/statuses-table.png)

Image shows the Customer Statuses table.

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

* **Reorder** — drag rows up or down. The same order is used everywhere statuses are listed.
* **Change the default** — flip the switch in the **Default** column. The previous default is turned off automatically.
* **Edit** — click the menu icon at the end of a row and click **Edit** to change the name, color, order, or default setting.
* **Delete** — click the menu icon and click **Delete**.

> [!NOTE]
>
> A status that's still in use can't be deleted. If any contacts have 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 Sources](https://docs.chatflows.io/core-setup/sources.md)
>
> Track where your contacts came from.

> [card] [Customer Groups](https://docs.chatflows.io/core-setup/groups.md)
>
> Organize contacts into named collections.


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