35 posts tagged with "Promotions Builder"

MINOR Removed per_application promotion codes in Rule Promotions

As announced on June 16, 2026, the per_application value for the consume_unit field has been removed when creating promotion codes for Rule Promotions.

What's Changed?

• consume_unit: per_application is no longer supported - Requests that create Rule Promotion codes with per_application, either directly or through a bulk code generation job, now return a 422 Unprocessable Entity error; set consume_unit to per_checkout or omit the field to use the default
• Existing codes are retained - Promotion codes already created with consume_unit: per_application continue to work as configured
• Rule Promotions only - This change applies only to Rule Promotions. Promotion codes for standard (V1) Promotions are not affected

For details see:

• Create Promotion Codes
• Bulk Create Promotion Codes

MINOR Tiered cart subtotal discounts in a single promotion

You can now set up all tiers of a tiered cart discount in one promotion in Promotions Builder. Each tier is its own Cart discount action with a cart subtotal range, so you no longer need a separate promotion for each tier.

What's New?

• Cart subtotal ranges on cart discounts - Use +refine on a cart discount action to add a Cart subtotal range. The discount applies only when the cart subtotal is within that range, inclusive of both amounts
• Multiple tiers per promotion - Add one cart discount action per tier, and use Duplicate action to copy an existing tier, including its range and inclusions, then change the percentage and range
• Inclusions and exclusions on ranges - Add inclusions or exclusions, such as a category, to a range to control which items count toward the cart subtotal for that tier. When a tier applies, the discount applies to the whole cart subtotal
• Open-ended top tier - Leave the maximum amount blank to apply a tier to any cart subtotal equal to or greater than the minimum amount

Promotions Builder doesn't check tiers for overlaps or gaps, so make sure your ranges don't overlap and only one tier applies to a cart. Create the lowest tier first and add higher tiers in ascending order. Otherwise, a higher tier's discount can reduce the cart subtotal into a lower tier's range and both discounts apply.

For details see:

• Tiered Promotion
• Creating a Cart Discount Promotion
• Creating Tiered Cart Discounts

MINOR Upcoming deprecation of per_application promotion codes in Rule Promotions

On September 14, 2026, we will remove the per_application value for the consume_unit field when creating promotion codes for Rule Promotions.

What's Changed?

• consume_unit: per_application removed on September 14, 2026 - After this date, new promotion codes for a Rule Promotion can no longer be created with per_application; set consume_unit to per_checkout or omit the field to use the default
• Existing codes are retained - Promotion codes already created with consume_unit: per_application continue to work as configured
• Rule Promotions only - This change applies only to Rule Promotions. Promotion codes for standard (V1) Promotions are not affected

For details see:

• Create Promotion Codes
• Creating Promotion Codes in Commerce Manager

MINOR Promotions Builder now supports cart_total as an action condition on cart_discount actions

What's New?

• You can now gate a cart_discount action behind a cart total threshold using the condition field. For example, you can create tiered cart_total discounts using multiple cart_total conditions in a single promotion.

For details see:

• Promotions Builder API Overview

MINOR Custom Attribute-Based Condition for Cart Items

You can now target cart items based on their custom attributes when creating promotions in Promotions Builder.

What's New?

• Custom attributes on cart items - Specify custom attributes to be added to cart items for use in promotional targeting.
• Custom attribute targeting - Create promotion conditions that target cart items by their custom attributes, enabling more precise promotional rules.

For details see:

• How to create promotion with item custom attribute
• Cart Items
• Promotions Builder API

MINOR Max Units Limitation for Promotions

You can now set a maximum quantity limit across all eligible items in a promotion. This new Maximum discounted quantities across all eligible items option allows you to cap the total number of units that receive a discount.

What's New?

• Cross-item unit cap - Set a total unit limit that applies across all eligible SKUs, not per-SKU

For details see:

• Creating an Item Discount with Max Units Limitation Guide
• Rule Promotions API

MINOR Support for Additional Comparison Operators in Cart Custom Attributes

What's New?

• Promotions Builder now supports advanced comparison operators for cart custom attributes.

  • is equal to
  • is greater than
  • is equal or greater than
  • is less than
  • is equal or less than

• Enables scenarios like:

  • Offering a discount to customers with a Lifetime Value (LTV) greater than 1000.

  • Targeting items in the cart with a weight less than 20 for promotional discounts.

These enhancements provide greater flexibility for building highly customized promotion logic based on numeric cart-level attributes.

For details see:

• Cart Custom Attributes
• Promotions Builder with Cart Custom Attributes

MINOR More Flexibility with Account Tag Rule Operators We've expanded the Account Tags feature in Promotions Builder by introducing two new rule operators to exclude specified account tags from promotion eligibility. These additions support fine-tuning promotions for specific accounts groups. For example, a merchant can make a promotion available to retail customers while omitting employee-tagged accounts to keep internal pricing separate.

What's New?

• New rule operators for Account Tags: not all, none.
• Available in the Promotions Builder rule configuration UI under "Account tag condition".

For details see:

• Creating Account Tag Condition in Promotions Builder
• Promotions Builder API

MINOR Export Item Lists as CSV in Promotions Builder You can now export item lists used in promotion conditions as CSV files directly from the Promotions Builder interface. This feature makes it easier to review, audit, and share the products, bundles, or other items included in your promotion rules.

What's New?

• Export CSV functionality for item lists in promotion conditions and actions.

For details see:

• Creating a Promotion in Promotions Builder

MINOR Cart Custom Attributes Limit Increased to 100 and Automatic Promotion Quota Added

What's New?

• Expanded attribute capacity - Carts can now support up to 100 custom attributes, up from the previous limit of 20, supporting additional business-specific information and sophisticated promotion conditions.
• Automatic promotion quota - rule promotions now support a maximum of 50 active and future automatic rule promotions per store.

Custom attributes remain persistent throughout the cart lifecycle and automatically carry over to order objects upon checkout, maintaining consistency across the purchase flow.

For details see:

• Create a Cart - Custom Attributes
• Creating a Promotion in Promotions Builder
• Promotions Builder API

MINOR Search Carts by Name for Client Admin Users

Client Admin users can now search for carts associated with an Account or Customer using cart name filtering.

What's New?

• Cart name search - Filter Account- or Customer-associated carts using the ilike operator to search by cart name.
• Combined filtering - Search using a combination of cart name and account ID.

Note: Carts without shopper associations are not currently searchable. Support for searching all carts will be added in a future release.

For details see:

• Get all Carts

MINOR Improved Promotion Builder Editing Experience

We've introduced several enhancements to make editing promotions in Commerce Manager smoother and more intuitive. These updates help users stay oriented, work more efficiently, and manage product selections with greater ease.

What's New?

• Focused Editing Experience: Promotion details now open in a dedicated workspace, reducing distractions and maintaining context.
• Preserved List View Settings: When returning to the promotions list, previous filters and search terms remain intact, allowing users to resume work seamlessly.
• Streamlined Product Selection: The product selection interface has been simplified for faster and more straightforward item selection.
• Faster SKU Entry: Users can now paste a comma-separated list of SKUs directly from the main view, eliminating extra form fields and reducing friction.
• Add Custom SKU - Enter a custom SKU directly into the text field by selecting Add.
• Promotion Options Menu: Options to duplicate, delete, or view promotion properties have been moved to their own menu for better organization.

These enhancements are designed to improve the workflow for merchandising teams managing large promotion catalogs, making it easier to create, edit, and organize promotional campaigns without losing context or repeating work.

For details see:

• Creating a Promotion in Promotions Builder
• Promotions Builder Overview

BETA Try Cart Preview to Validate Promotions, Pricing, and Catalogs

We're launching Cart Preview in Commerce Manager as a beta feature—designed to help teams simulate real-world cart scenarios for validating catalog setups, pricing, and promotion evaluations.

What's New?

• Preview how your catalog and pricing will behave in a live cart environment.
• Test promotion rules and shopper-specific conditions before deployment.
• Gain confidence in your configurations without needing a separate storefront.
• Planned: Support for account tags, custom attributes and custom SKUs

Cart Preview is currently in beta and available for early feedback.

See Commerce Manager Cart Preview

MINOR New Promotions Builder Operator: Range Support for Cart Conditions

We’ve added a new operator to the Promotions Builder that allows you to define value ranges for cart-based conditions—giving you more flexibility when crafting targeted offers.

How to setup tiered promotion

MAJOR Introducing Account Tags for Promotions

We’ve introduced Account Tags, a flexible new feature that lets you dynamically group similar shoppers together, making it easier than ever to deliver targeted promotions.

Use Case Example Create a "VIP" tag to identify high-value customers and automatically offer them exclusive discounts that go beyond what regular shoppers receive.

What’s New

• Create and assign tags to customer accounts.
• Build promotions using Account Tags as conditions—any shopper with the assigned tag will receive the targeted offer.

For details see:

• How to create promotion with Account Tags
• Account Tags Management
• Promotion with Account Tags
• Account Tags API

MINOR Enhanced Currency Support in Promotions Builder

We've expanded currency support in Promotions Builder to allow promotions to apply across all available currencies, providing greater flexibility for global merchants.

What's New?

• Added "All Currencies" option in the currency dropdown, allowing promotions to apply to all supported currencies
• Rule Promotions still default to the store's default currency, maintaining existing behavior
• Important note: All currencies option works best with percent discounts, as fixed discounts won't factor in exchange rates when applied to multiple currencies

MINOR Configure Auto Add free item with Promotions Builder

New! Gift with Purchase Promotions​

• You can now use our Promotions builder to create Gift with Purchase (GWP) promotions. Shoppers who qualify for a GWP offer will have the free gift automatically added to their cart, streamlining their experience and making it easier for them to claim their reward.

New! Promotion Carrots: Buy X Get Y (BXGY) Suggestions​

• We've expanded our Promotions builder to include Buy X Get Y (BXGY) product suggestions. For qualifying BXGY offers, our system can now provide front-end suggestions for the 'Y' products. This helps shoppers effortlessly find and add the discounted items to their cart, streamlining their purchasing journey.
• This feature can also be used for free-gift promotions when there is a choice of free-gift options, requesting the shopper to make a choice to add one to the cart.

For details see:

• How to Create Auto Add Free Item Promotion
• Create Auto Add Promotion with Promotions Builder
• Create Rule Promotion API

MAJOR Boost Average Order Value with Bundle Promotions in Promotions Builder

We’ve launched a powerful new capability in Promotions Builder: Bundle promotions. This empowers merchandisers to create compelling promotions that target groups of items to drive higher order values and increased conversions.

What's New?

• A new option in Promotions Builder allows you to define a group of items as a promotional condition, and apply a discount to the same or different group of items, making it easier to design bundle-based offers.

For details see:

• How-To Example
• Create Bundle Promotion with Promotions Builder
• Create Bundle Promotion API

MINOR Improvements Based on User Feedback

We've enhanced our Promotions Builder to be more user-friendly and to support more promotion conditions.

What's New?

• The notable update is that all the promotion limitations are now under the '+refine' section of the promotion configuration.

MINOR Enhanced SKUs and SKU-less Item Handling in Promotions Builder.

We've improved SKU and SKU-less item handling in the Promotions Builder. While this change is more noticeable in API requests, the Commerce Manager experience remains unchanged.

• Merchandiser can handle SKU and SKU-less items within a single condition using the new item_identifier strategy.
• The item_identifier strategy is supported in both promotion conditions and actions, providing greater flexibility.
• All existing promotions using item_sku OR item_product_id will remain supported.
• New promotions created in the Commerce Manager Promotions Builder will automatically use the new item_identifier strategy.

See Create a Rule Promotion API Examples

MINOR Improved List Pages. We've enhanced the table functionality on our list pages with the following:

• Select which headers show on the table with customizable headers
• View up to 100 items on the page
• Hover over dates to see the date and time details for your location's time zone as well as UTC time zone
• Dynamic search that shows all results with related terms
• Select filters and bookmark the page to return and view the page with selected filters again.

We are making similar changes on list pages across Commerce Manager in the upcoming days.

MINOR Override Stacking in the Promotions Builder.

We added a new flag to provide more stacking flexibility for the merchandisers. The Override Stacking flag can be used alongside the existing stacking capabilities. See Creating Override Stacking Promotion.

See Promotions Builder Override Stacking API

MINOR We have expanded promotions filtering to include the promotion statuses such as Enabled, Disabled, Scheduled, Running, Expired, Stacking, and Override Stacking for Promotions Builder. Use these filters to see a subset of promotions in the Promotions Builder.

For Commerce Manager, see Promotions Filtering

For API, see Promotions Filtering

MINOR We have expanded promotions search to include search by promotion name for Promotions Builder. You can search for promotions with the Promotion Name or Coupon Code.

For Commerce Manager, see Searching for Promotions

For API, see Promotions Filtering

MINOR We have introduced a new coupon code limitation to assign the maximum times a shopper can apply the code. This helps merchants limit the number of times a public coupon code can be used per shopper. For example, you can set a promotion to be used by first 100 shoppers (including or excluding guest shoppers) and each shopper can only use the promotion code once. Read more on Creating max uses per shopper promotion codes.

For Commerce Manager, see Adding Limitations

For API, see Create Max Uses Per Shopper Promotion Codes

MINOR We have introduced bulk codes generation, and export for Promotions Builder.

Read more on Managing Bulk Promotion Builder Codes.

For API, see Bulk Create Promotion Builder Codes

For Commerce Manager, see Bulk generate promotion codes

MINOR We have introduced inclusions support in the Promotions Builder, enabling users to fine-tune the targeting of eligible and discounted items. For example, you can target items from specific categories or with specific attributes for both eligibility and discounts. Read more on Creating promotions with inclusions.

For Commerce Manager, see Adding Inclusions

MINOR We have introduced Flows support for Promotions Builder that allows users to create custom fields for promotions. For example, you can create custom fields to display custom promotion terms and conditions messaging in the storefront.

For API, see The Promotions Builder Custom Fields API.

For Commerce Manager, see Editing custom fields in a promotion builder

MINOR We have introduced the ability to select SKU-less product bundles in the promotion builder's product selector. For more information, see Creating a Cart Items Condition in Commerce Manager.

MAJOR We have introduced a new feature allowing the creation of shipping discount for cart shipping groups. For more information, see Create a Shipping Discount API, and Creating a Shipping Promotion in Commerce Manager.

MAJOR We have introduced a new feature allowing the creation of promotion codes specifically for first time shoppers, who have not yet completed a purchase with the store. Within Commerce Manager, you can now create a single code and select the option to apply it exclusively for first time shoppers. For more information, see Creating a Single Code.

For details on creating a first time shopper promotion code via the API, see Create First time Shopper's Coupon Code.

MINOR Commerce Manager: We have added a new feature allowing you to duplicate an existing promotion in Promotions Builder. For more information, see Duplicating a Promotion.

MINOR Commerce Manager: In Store > Promotions Builder, you can now use the new Search coupon code field to search a promotion code across all promotions. For more information, see Searching a Promotion Code.

MINOR Commerce Manager: We have added the capability to copy exclusions between the Conditions and Actions sections in the Promotions Builder. For more information, see Creating a Promotion in Promotions Builder.