# Customer Tag Limit

The **Customer Tag Limit** feature allows merchants to restrict purchases of selected products for customers who belong to specific customer tags, based on either **total quantity** or **total order amount**. This is useful for controlling bulk purchases, setting wholesale limits, or managing exclusive product access for specific customer groups.

#### Create Customer Tag Limit

Use the following settings to configure purchase limits based on customer tags.

#### 1. Activate Customer Tag

* **Activate Customer Tag**\
  Enable this option to apply quantity limits only to customers who have specific tags assigned to their customer profile.
* Once enabled, the limit will be enforced **only for tagged customers**. Other customers will not be affected.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fl1p1NpsNhBCeqPhnd0qn%2Fimage.png?alt=media&#x26;token=4a525eca-7968-4050-8944-6d44ad2d252e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FUXKEAqBnVpGK8oGwI4lk%2FScreenshot_44.jpg?alt=media&#x26;token=2fae6a98-14e0-45dd-a2d5-08c7ce84a960" alt=""><figcaption></figcaption></figure>

#### 2. Select Products

* **Select Products**\
  Choose one or multiple products to which the customer tag limit should apply.
* The defined limit will be calculated as the **total quantity across all selected products**, not per individual product.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Ftv3D5uO8beQ9lgJz1XvV%2FScreenshot_45.jpg?alt=media&#x26;token=e68798dd-e714-4bef-8c9a-98b22f5431ea" alt=""><figcaption></figcaption></figure>

#### 3. Quantity Limit

* **Limit**\
  Set the maximum total quantity that a customer with the selected tag(s) is allowed to purchase.
* If the customer tries to add more than the allowed quantity (across the selected products), the system will prevent checkout and display a restriction message.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fiqz7q1kMfV1jD9OXF18F%2Fimage.png?alt=media&#x26;token=a2341e30-7bef-4da1-b9aa-d9318ae94267" alt=""><figcaption></figcaption></figure>

#### Example

* Customer Tag: Wholesale
* Selected Products: Product A, Product B
* Quantity Limit: `5`

If a customer with the **Wholesale** tag adds:

* 3 units of Product A
* 2 units of Product B

The order is allowed.\
If they attempt to add **more than 5 units in total**, the restriction will apply.

#### 4. Amount Limit

**Limit**\
Set the maximum total order amount that a customer with the selected tag(s) is allowed to purchase.

If the customer tries to exceed the allowed amount (across the selected products), the system will prevent checkout and display a restriction message.

#### Example

**Customer Tag:** Wholesale\
**Selected Products:** Product A, Product B\
**Amount Limit:** $500

If a customer with the Wholesale tag adds:

* Product A is worth $300
* Product B is worth $200

The order is allowed.

If they attempt to exceed a total of $500, the restriction will apply.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FkUQXKiPgDQfKdSxgQCz1%2Fimage.png?alt=media&#x26;token=943a69d8-7309-4a37-9ac2-c24ef743576d" alt=""><figcaption></figcaption></figure>

Once configured, the **Customer Tag Limit** will automatically apply during add-to-cart and checkout, ensuring controlled purchasing behavior for tagged customers.
