In VTEX, a benefit or discount can be applied to a group of customers. This group of customers can be defined by properties that they have in common.
This article describes how Master Data v1 works. It is important that you evaluate which Master Data version meets the needs of your operation or is already in use.
This article shows how to configure a benefit for employees. It is considered that the employees are a group of customers, so they are identified using Master Data clusters.
Since customer data is stored as documents of the CL (Client or Cliente) data entity in Master Data, the content of the fields will decide if the customer belongs to that group.
What is a cluster?
In Master Data, a cluster is a field with a determined value for a data entity. One or more clusters define this group of customers with common properties in the CL data entity.
Here, the common property of the clients will be that they are also employees of the store. More information about clusters of customers can be found in the article Create a cluster of customers.
This article assumes that the employees are properly registered with a boolean field isEmployee
set to true in their respective documents for the CL data entity, as shown in the figure below.
If they are not, check the article Creating a field in Master Data to create a field that identifies the employees and properly configure it for each document corresponding to the employees.

There are many details to completely configure a benefit. If you need additional information on this matter, check out the article Creating promotions.
With the field configured, the benefit can be created by following the steps below:
- In the left panel of Admin, access Promotions > Promotions.
- With the Promotions menu open, click on the New Benefit button in the top right corner.
- Choose the desired type of benefit from the available options.
- Fill the required fields to set up the benefit. There are many fields (e.g.: Name, Expiration date, kind and amount of discount, etc.) and some of them are specific to the selected type of benefit. More information about configuring the benefits can be found in the article Creating promotions.
- To apply the benefit only to the employees, inside section 3 (What are the conditions for the benefit to be valid?), check the Customer cluster mark
- In the box below the Customer cluster mark, write the cluster that identifies the customers that are employees (a pair
{field}={value}
). In this case it is usedisEmployee=true
. - In the end of the page, click on the Save button.
After that, the benefit should already be working as configured. The discount is shown only in the shopping cart. The image below shows an example with 99% off.
