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

# Manage your Shopify customers

> Keep every customer in one list: Shopify shoppers, people who message you, and your imports. Find anyone fast, tag them, and start a chat.

Manage all your customers and leads in one place, from the **Customers** menu. Keeping your list organized makes it easier to find people, start conversations, send broadcasts, and use automations throughout ChatFlows.

> [!NOTE]
>
> Before creating contacts, connect at least one WhatsApp or Messenger channel. Without a connected channel, you can't create contacts or send messages. See [WhatsApp Setup](https://docs.chatflows.io/core-setup/channels/whatsapp.md) to set up.

## Creating a contact

**1. Open Customers**

Click **Customers** in the sidebar menu.

**2. Click Add Contact**

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

![New Contact form with Details and Custom Fields tabs, showing fields for first and last name, phone, email, type, assigned to, status, source, WhatsApp channel, display name, groups, and labels](https://docs.chatflows.io/contacts/img/contact-form.png)

Image shows the New Contact form.

Fields marked with a red `*` are required: **First Name**, **Phone**, **Type**, **Status**, **Source**, and **Link to WhatsApp Channel**. The rest are optional.

**3. Enter the name**

Fill in **First Name**. Add the **Last Name** if you know it.

**4. Enter the phone number**

Fill in **Phone**. Pick the correct country code from the dropdown next to the number.

**5. Enter the email**

Fill in **Email** if you have it.

**6. Choose the type**

Pick **Lead**, **Customer**, or **Guest** in the **Type** field.

**7. Assign a team member**

Pick a team member in **Assigned To**. Leave it as **Unassigned** if nobody is handling this contact yet.

**8. Choose a status**

Pick the contact's current stage in the **Status** field. Click the `+` icon to create a new status without leaving the form.

**9. Choose a source**

Pick where the contact came from in the **Source** field. Click the `+` icon to create a new source without leaving the form.

**10. Link a WhatsApp channel**

Pick your WhatsApp account in **Link to WhatsApp Channel**.

**11. Add a display name**

Fill in **Display Name** if you want a specific name shown across ChatFlows. Leave it empty and ChatFlows will fill it in for you.

**12. Add groups and labels**

Pick one or more **Groups** and **Labels**. Click the `+` icon to create a new customer group or customer tag without leaving the form.

**13. Fill in custom fields**

If you created [customer fields](https://docs.chatflows.io/core-setup/custom-fields.md), open the **Custom Fields** tab at the top of the form and fill them in. A red `*` on the tab means a required field is still empty.

**14. Save**

Click **Save**. The contact is added and appears in your list right away.

> [!NOTE]
>
> Contacts aren't only created by hand. When a new person messages you first, ChatFlows saves them as a contact automatically, with a default status, source, and more. Customers from your connected Shopify store are added the same way, matched by phone number, and their Shopify tags become customer tags. You can choose those defaults in [Settings → Customers](https://docs.chatflows.io/settings/contact-configuration.md).

## Fields worth knowing more about

**Assigned To**

The team member responsible for this contact. Use it so your team knows who follows up.

**Link to WhatsApp Channel**

The [WhatsApp account](https://docs.chatflows.io/core-setup/channels/whatsapp.md) used to message this contact. Required when creating a contact.

A contact can be linked to more than one WhatsApp channel. Every time you edit the contact and pick a channel here, that channel is added to the contact. The channels already linked stay as they are. This is useful when the same customer reaches you on two different WhatsApp numbers of your business.

**Custom Fields**

Extra details you decide to store, such as a company name or an order number. See [Customer Fields](https://docs.chatflows.io/core-setup/custom-fields.md) to create your own.

## Editing a contact

Click the menu icon at the end of a contact's row and click **Edit**. The same form opens with the details already filled in. Change what you need and click **Save**.

## Viewing contact details

Click a contact's name to open their details panel. You can view details here but not change them — except notes, which you can add and edit from the **Notes** tab.

![Contact detail sheet with Contact Details, Custom Fields, and Notes tabs, showing the contact's type and labels, source, assignee, last message and created times, groups, and linked message channels](https://docs.chatflows.io/contacts/img/contact-detail.png)

Image shows the contact detail panel.

The panel has up to three tabs:

* **Contact Details** — type, labels, source, assigned team member, groups, message channels, and the last message and created times.
* **Custom Fields** — the values saved in your custom fields. Shown only when the contact has custom-field values.
* **Notes** — internal notes about this contact.

### Using notes

Notes are for your team only. The contact never sees them.

![Notes tab in the contact details panel with a text box to add a note, an Add Note button, and an existing note with edit and delete icons](https://docs.chatflows.io/contacts/img/contact-notes.png)

Image shows the Notes tab in the contact panel.

Use notes to record follow-up reminders, customer preferences, or what was discussed on a call. Open the **Notes** tab and click **Add Note** to write one. You can edit or delete a note at any time.

## Actions on a single contact

![Customers table with a row menu open listing View, Edit, Open chat, Initiate chat, Send flow, Merge with, and Delete](https://docs.chatflows.io/contacts/img/contact-row-actions.png)

Image shows the row actions menu on a customer in the Customers table.

Click the menu icon at the end of a contact row to see these actions:

* **View** — open the contact details panel.
* **Edit** — open the contact form to change details.
* **Open chat** — go to the existing conversation with this contact. Shown only when the contact has already chatted with you.
* **Initiate chat** — start a new WhatsApp conversation by sending an approved template message. Shown only when the contact has a phone number and a linked WhatsApp channel. See [Inbox](https://docs.chatflows.io/messaging/live-chat.md) to understand the 24-hour messaging window.
* **Send flow** — send one of your [WhatsApp Forms](https://docs.chatflows.io/messaging/whatsapp-forms.md) to this contact. Shown only when the contact has a phone number and a linked WhatsApp channel.
* **Merge with…** — join this contact with a duplicate record. See [Bulk Actions & Merge](https://docs.chatflows.io/contacts/bulk-actions-and-merge.md).
* **Delete** — remove the contact. This also permanently deletes their conversations and chat media, and cannot be undone.

To turn a contact off without deleting them, use the toggle in the **Active** column of the table. Turn it back on anytime.

## Finding contacts

![Customers table with the Filters panel open showing Type, Status, Source, Active, Assignee, and Channel dropdowns](https://docs.chatflows.io/contacts/img/contacts-list-filters.png)

Image shows the Customers table with the Filters panel open.

As your list grows, use these to find the right people quickly:

* **Search** — type a name, phone number, or email in the search box.
* **Type tabs** — click **All**, **Leads**, **Customers**, or **Guests** at the top to show only that type.
* **Filters** — click **Filters** to narrow the list by:
  * **Type** — Lead, Customer, or Guest.
  * **Status** — the current stage of the contact.
  * **Source** — where the contact came from.
  * **Active** — show only active or only inactive contacts.
  * **Assignee** — the team member handling the contact.
  * **Channel** — the WhatsApp or Messenger account the contact is linked to.

> [!TIP]
>
> Filters also help with bulk work. Filter your list first, then select all matching contacts to update them together. See [Bulk Actions & Merge](https://docs.chatflows.io/contacts/bulk-actions-and-merge.md).

## What's next

> [card] [Import & Export](https://docs.chatflows.io/contacts/import-export.md)
>
> Add many contacts at once from a CSV or Excel file.

> [card] [Bulk Actions & Merge](https://docs.chatflows.io/contacts/bulk-actions-and-merge.md)
>
> Update many contacts together, or join duplicates.

> [card] [Customer Fields](https://docs.chatflows.io/core-setup/custom-fields.md)
>
> Store extra details on every contact.

> [card] [Campaigns](https://docs.chatflows.io/messaging/campaigns.md)
>
> Send a message to a group of contacts.


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