{"section":"tutorials","requestedLocale":"en","requestedSlug":"how-can-i-create-cluster-of-customers","locale":"en","slug":"how-can-i-create-cluster-of-customers","path":"docs/en/tutorials/master-data/customer-relations-management/how-can-i-create-cluster-of-customers.md","branch":"main","content":"A customer cluster is a way to segment customers into groups. This can be achieved by creating a boolean field in **Master Data** (e.g., `Resellers`, `VIP`, `Employees`). Customers marked as `true` for that field belong to the cluster, while the rest don't. Once created, you can use clusters to target specific customer segments with exclusive promotions, personalized campaigns, or tailored experiences.\n\n> ℹ️ This article covers Master Data v1. Learn more about [Master Data versions](/en/docs/tutorials/master-data#versions-available) and [Master Data v2](https://developers.vtex.com/docs/guides/master-data-v2-basics).\n\n## Creating a customer cluster field\n\nFollow the steps below to create a customer cluster:\n\n1. In the VTEX Admin, go to **Master Data**.\n2. Create a new boolean field in the customer (`CL`) data entity with the name of the desired cluster (e.g., `Resellers`, `VIP`, `Wholesale`). See [Creating a field in Master Data](/en/docs/tutorials/how-can-i-create-a-field-in-master-data) for details.\n3. Set the field as **searchable** and **filterable**. This is required for the cluster to work correctly with promotions.\n4. Add the field to the customer form so it becomes visible when viewing customer data. See [Creating a field in Master Data](/en/docs/tutorials/how-can-i-create-a-field-in-master-data) for details.\n\n## Populating the cluster\n\nAfter creating the cluster field, you need to set it to `true` for each customer you want to include in the cluster. You can do this using one of the following methods:\n\n- **Spreadsheet import:** Use the [Master Data v1 import feature](/en/docs/tutorials/importing-data-into-master-data-v1) to bulk-assign customers.\n- **API:** Update customer records programmatically through the [Master Data API](https://developers.vtex.com/docs/api-reference/masterdata-api).\n- **Manual entry:** Edit individual customer records in the CRM customer form.\n\n## Learn more\n\n- [Creating promotions for a cluster of customers](/en/docs/tutorials/creating-promotion-for-a-customer-cluster)"}