--- updatedAt: 2026-05-20T05:10:02.000Z agentTools: projectIndex: https://docs.deducto.io/llms.txt --- # Brand Sale ## When to use this Use this template when you want to discount every product from a particular brand – for example "20% off all Nike". Customers don't enter a coupon; the discount applies as soon as a matching item is in their cart. ## How it works This is an `Item Group` promotion that filters by a brand attribute and applies a percentage discount. Three pieces of the configuration do the actual work: * **Item Group conditions** – the promotion matches any product whose `Brand` attribute is the brand you nominate (e.g. `Nike`). With `Quantity` set to `1`, each matching item forms its own item group, so every Nike item in the cart gets the discount independently. * **Percentage action** – a flat 20% discount is applied to each matched item group. The `Batch Limit` is `0`, so the promotion applies to as many qualifying items as the customer has. * **`Lock Affected Items: Yes`** – stops a Nike item from also receiving a stacking discount from a later promotion. No trigger conditions are needed – eligibility is purely item-level. For the underlying concepts see [Trigger Conditions](https://docs.deducto.io/docs/creating-a-promotion#trigger-conditions), [Item Groups](https://docs.deducto.io/docs/creating-a-promotion#item-groups), and [Promotion Action](https://docs.deducto.io/docs/creating-a-promotion#promotion-action) in *Creating a Promotion*. The `Brand` attribute is a project-level custom attribute. For non-Shopify projects, see [Attributes](https://docs.deducto.io/docs/attributes#) for how to define a brand attribute. Once defined, you can pick the brand from the [Entity Searcher](https://docs.deducto.io/docs/entity-searcher#) (if your project has a search integration set up); otherwise enter the brand name as plain text via `Bulk Add`. On Shopify projects, you do not need to create a separate `Brand` attribute. During onboarding, Deducto creates a `Vendor Title` attribute that maps to Shopify's native `vendor` field, and the Entity Searcher's `Vendor` index is pre-configured. Substitute `Vendor Title` for `Brand` wherever the steps below mention it. ## Step-by-step setup 1. From your Deducto Dashboard, open the promotions list for your project and click `New`. 2. Choose `Item Group` as the promotion type. 3. On the `General Information` tab, set the name, schedule, and behaviour. The full set of values is in the [field reference](#field-reference) below. 4. On the `Trigger Conditions` tab, leave the conditions empty. 5. On the `Item Groups` tab, configure the default group: * Name it `Nike Item`. * Set `Quantity` to `1`. * Add one condition: select `Brand` (or `Vendor Title` on Shopify projects) as the attribute, choose `is one of`, then either use the [Entity Searcher](https://docs.deducto.io/docs/entity-searcher#) (if you have a search integration set up) to pick `Nike` from your catalogue, or use `Bulk Add` to enter the value `Nike` directly. 6. On the `Action` tab, choose `Apply A Percentage Discount to Item Group(s)`, set `Percent` to `20`, and check the `Nike Item` group under `Target Item Groups`. Leave all the limits at `0`. 7. Click `Save`. ## Variations * **Different brand.** Change the value in the item group's `Brand` condition (e.g. `Adidas`, `Puma`). * **Different discount amount.** Adjust `Percent` on the Action tab. * **Fixed amount instead of percentage.** Switch the action to `Apply A Fixed Amount Discount to Item Group(s)` and set the amount. * **Cap how many items get discounted per cart.** Set `Batch Limit` to a non-zero number on the Action tab. * **Cap the total discount per cart.** Set `Maximum Discount Amount` on the Action tab. * **Allow stacking.** Set `Lock Affected Items` to `No` so Nike items can also receive other discounts. ## Testing 1. Add a Nike item to your cart and confirm the 20% discount appears. 2. Add multiple Nike items and confirm each receives the discount. 3. Add a non-Nike item alongside and confirm it does *not* receive the discount. *** ## Field reference The full set of fields used by this template: | Section | Field | Value | | :------------------ | :------------------------------ | :------------------------------------------- | | General Information | Name | Spring Sale 20% Off Nike | | General Information | Description | 20% off all Nike products | | General Information | Requires Coupons | No | | General Information | Supported Currencies | AUD | | General Information | Timezone | Australia/Sydney | | General Information | Status | Enabled | | General Information | Start | 2026-05-01 00:00:00 | | General Information | End | 2026-05-31 23:59:59 | | General Information | Priority | 1 | | General Information | After Processing Action | Continue | | General Information | Lock Affected Items | Yes | | General Information | Max Use Count Per Coupon | 0 | | General Information | Max Use Per Email Address Count | 0 | | Trigger Conditions | – | (none) | | Item Groups | Name | Nike Item | | Item Groups | Quantity | 1 | | Item Groups | Condition | `Brand` `is one of` `Nike` | | Action | Type | Apply A Percentage Discount to Item Group(s) | | Action | Percent | 20 | | Action | Maximum Discount Amount | 0 (no cap) | | Action | Batch Limit | 0 (unlimited) | | Action | Item Group Qty Limit | 0 (no limit) | | Action | Item Group Qty Limit Mode | (default – not used at these settings) | | Action | Target Item Groups | Nike Item |