Elastic Path Changelog

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 Location-Based Cart Item Separation

You can now control how cart items with the same SKU but different inventory locations are handled. When the separate_items_by_location setting is enabled, items with the same SKU are kept as separate line items based on their location instead of being merged.

What's New?

• Location-based item separation - Enable or disable location-based item separation by setting separate_items_by_location to true or false. When enabled, cart items with the same SKU but different inventory locations are kept as separate line items instead of being merged.

  • Can be set at the store level or for individual carts with the setting: "item_settings": { "separate_items_by_location": true }. By default, it is false.

• For details see:

• Carts settings API

• Multi location inventories

• Cart item with location 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 External Reference ID for Shipping Groups

Cart and order shipping groups now support an external_ref field, enabling merchants to link shipping groups to external systems such as ERPs.

What's New?

• External reference field - Shipping groups support an external_ref field for integration with external systems. Set it when creating cart shipping groups, or update it on existing cart or order shipping groups without affecting other data.
• Checkout persistence - When a cart with shipping groups is checked out, the external_ref values are preserved on the resulting order shipping groups

For details see:

• Cart Shipping Groups

MAJOR Custom API Navigation Placement

Users can now configure where Custom APIs appear in the Commerce Manager navigation sidebar, providing greater flexibility in organizing their workspace.

What's New?

• Navigation placement - Choose which main section your Custom API appears under: Home, Merchandise, Orders, Subscriptions, Composer, Extensions, or Settings
• Sub-section nesting - Optionally nest Custom APIs under specific sub-sections within a main section (e.g., Products within Merchandise)

For details see:

• Commerce Extensions in Commerce Manager

MAJOR Catalog Search - Built-in Search for Your Storefront

Elastic Path now includes Catalog Search, a fully integrated search service that provides fast, relevant product discovery for your storefront. Search is built directly into Elastic Path Commerce Cloud and your catalogs, eliminating the need for third-party search vendors and complex integration work.

What's New?

• Store search enablement - Enable search for your store or organization and go live without configuring a separate search provider.
• Automatic catalog indexing - When you publish a catalog, products are automatically indexed and become searchable. Multiple catalogs (e.g., live and pre-live) can be indexed simultaneously, with catalog rules and shopper context controlling which catalog a shopper searches.
• Configurable searchable attributes - Control which product fields drive search results, including product name, description, SKU, and custom extended attributes from your templates.
• Faceted search and filtering - Shoppers can filter results by categories, attributes, price ranges, and more. Configure which attributes are facetable to power your filtering UI.
• Sorting - Sort search results by relevance, price, or custom attributes.
• Typeahead and keyword search - Provide instant suggestions as shoppers type, guiding them toward the right products and categories.
• Search profiles - Create different search behaviors for different use cases. Weight fields differently (e.g., emphasize size and material for rugs, finish and style for lighting), apply filters, and configure boost rules.
• Query boosting - Promote or demote products based on categories, tags, or attribute values. Boost seasonal collections, featured products, or sale items to the top of results.
• InstantSearch.js adapter - Integrate search into your storefront using the popular InstantSearch.js library with our adapter package.

For details see:

• Catalog Search Overview - Enable search for your store
• Indexing - Configure searchable attributes
• Profiles - Set up search profiles and boosting rules
• Setting Up Catalog Search (API) - API-based configuration
• InstantSearch Adapter - Build search UIs with InstantSearch.js

MAJOR New Custom Field Types for Custom APIs

What's New?

Two new Custom Field types have been added to allow even more extensibility in Custom APIs:

• List Field Type - Store Administrators can now create Custom Fields with the list field_type to store array of simple values (string, integer, boolean, float). This type support a range of validation and filtering options.
• Any Field Type - Store Administrators can now create Custom Fields with the any field_type to store arbitrary JSON in Custom APIs. These types do not support filtering.

For details see:

• Custom Fields
• Custom Fields in Commerce Manager

MINOR Generated OpenAPI Specs for Custom APIs

You can now view or download OpenAPI specifications for all of your Custom APIs in Commerce Manager. This feature makes it easier to generate code leveraging Custom APIs.

What's New?

• View the OpenAPI spec in-app for any custom API.
• Download the OpenAPI spec to share with developers or import into API tooling.

For details see:

• Access OpenAPI Spec

MINOR Original Price Field in Cart and Order Items

What's New?

Cart and order items now include an original_price field under meta.display_price, providing visibility into the product's original catalog price before any catalog-level sales, tiered pricing adjustments, or cart/item level promotions are applied. This supports additional pricing visibility features, such as storefront strikethrough prices.

For details see:

• Get Cart Items
• Get Order Items

MINOR Catalog Delta Files for AI Product Feeds

Elastic Path now supports using Catalog Delta Files as a direct data source for OpenAI Product Feeds, enabling near real-time synchronization of product changes into AI-powered search, discovery, and agent workflows.

What's New?

• Delta files as AI ingestion source - Catalog Delta Files can now be used as an official feed input for OpenAI Product Feeds to support AI search, recommendations, and shopper agents.
• Change-based updates only - Delta files include only created, updated, and deleted products, eliminating the need for full catalog re-ingestion.
• Automatic generation on publish - Delta files are produced automatically during full and incremental catalog publish events.
• Optimized for AI pipelines - Reduced ingestion cost, faster update cycles, and improved data freshness for AI-driven experiences.
• Supports full product lifecycle changes - Includes updates to attributes, availability, pricing references, and product deletions.

For details see:

• Using Catalog Delta Files

MINOR Address Filtering in Account Address Book

Commerce Manager users can now quickly find specific account addresses using flexible filtering options in the Address Book tab.

What's New?

• Address filters in Commerce Manager - Use the Add Filter menu in the Address Book tab to filter addresses by fields such as first name, last name, name, company name, phone number, address lines, city, county/region, postcode, country, and instructions.
• Multi-criteria filtering - Combine multiple filters to narrow down long address lists for large B2B accounts.

For details see:

• Managing Accounts in Commerce Manager
• Account Addresses 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 Catalog Rules Now Support Account Tags

Catalog rules can now target accounts based on their tags, enabling flexible tag-based segmentation for B2B scenarios. Use the new account_tag_ids field to apply catalog rules to groups of accounts sharing common tags (e.g., "enterprise", "premium", "beta-testers").

What's New?

• Target account groups by tags instead of managing individual account lists in rules.
• Simplify management of pricing tiers, regional catalogs, and beta programs through tag-based segmentation.

For details see:

• Configure Shopper Catalog Rules
• Price Segmentation Guide
• Account Tags in Commerce Manager
• Account Tags API

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

MINOR Increased limit for account addresses to 500

We've increased the maximum limit for number of addresses to 500 per account.

• Default limit: 25 addresses per account
• Configurable: Up to 500 addresses (can be set by store admins)
• Extended limit: If you need higher limits, please contact us.

This enhancement provides greater flexibility for managing addresses across large-scale accounts and enterprise use cases.

For details see:

• Account Addresses API

MINOR Search carts by account ID

We've added filter support for searching carts by associated account IDs.

For details see:

• Carts API

MAJOR AI-Ready MCP Server for Elastic Path Composable Commerce Now Available

We've released the Elastic Path Composable Commerce MCP Server, enabling secure, real-time access to your Elastic Path APIs through the Model Context Protocol (MCP).

What's New?

• Provides AI assistants with deep operational access across orders, products, catalogs, pricing, promotions, and more.
• Empowers commerce teams to automate insights, streamline catalog management, and optimize pricing through natural language prompts.
• Supports secure authentication and token management, with simple setup using your Elastic Path credentials.

This beta release unlocks powerful new AI-driven commerce experiences while maintaining full control of your backend infrastructure.

Available now on npm: @elasticpath/elasticpath-mcp

Get started

MAJOR Updated Order Insights Dashboard

We’ve updated Order Insights Dashboard, giving merchandisers a powerful way to analyze order data with flexible, customizable views.

What’s New

• Aggregate order data by product SKU, product ID, promotion ID.
• View total sales ($), order count, and discounts ($) for filtered results.

For details see:

• Order Insights Dashboard

MINOR Support for Given Name, Family Name, and Middle Name Claims

We've enhanced Accounts and Single Sign-On (SSO) to support structured name fields, in addition to the existing name field, we've added:

• given_name – Stores the given (first) name of the user.
• family_name – Stores the family (last) name of the user, supporting cultures where family name comes first.
• middle_name – Stores the middle name of the user.

These values can be set directly by the API, but additionally will be populated during OpenID Connect authentication if your provider sets the Standard Claims, and

These fields can now be optionally set in user authentication info objects, and filtered in both user authentication info and account members.

For details see:

• Account Members API
• User Authentication Info API

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

MAJOR Dev MCP Server now available to help your AI agents build storefronts with Elastic Path.

We're launching the Dev MCP Server as a beta feature, designed to help developers connect AI-powered coding assistants directly to Elastic Path’s curated storefront knowledge.

What's New​

• Access curated code examples, API references, and SDK workflows for authentication, carts, checkout, and product discovery.
• Generate accurate storefront components with consistent, best-practice patterns — no manual searching required.
• Responses are curated by Elastic Path engineers for precision, consistency, and clarity.

Dev MCP Server is currently in beta and open for developer feedback.

MINOR Introduced Price Segmentation Support for Catalogs

Merchandisers can now deliver personalized pricing experiences at scale with the new price segmentation capability for catalogs.

What's New?

Added support for price-segmented catalogs, enabling association with hundreds of pricebooks, far beyond the previous 5 pricebook stacking limit.

Introduced the enable_price_segmentation attribute on catalogs:

• When set to true, all available pricebooks at publish time are included in the catalog.
• No need to define stacked pricebooks—simplifying catalog setup for personalized pricing scenarios.
• API responses now reflect rule-based pricing where available and fall back to catalog default pricing if no matching pricebook is found.
• Exposes multiple prices per product for search indexing and administration: meta.available_pricebook_ids and meta.available_prices are included in the hash file.
• Admin API can return all or filtered available prices using the EP-Pricebook-IDs-Of-Available-Prices-To-Show header.

This release significantly reduces catalog maintenance complexity while enabling large-scale personalized pricing.

For details see:

• Price Segmentation Guide

MINOR Expanded Taxation Support for Bundle Components

We've enhanced the way taxes are calculated for product bundles by enabling component-level tax support.

What's New?

• Taxes can now be applied individually to each product within a bundle.
• Each component item's tax is calculated separately, ensuring accuracy when items in a bundle are taxed differently.
• Supports compliance with regional tax rules where some products may be exempt or taxed at different rates.
• Supports bulk adding tax items to component items for bundles.

This update ensures that your bundled offerings remain tax-accurate across different markets.

For details see:

• Add tax to bundle component items API

INTEGRATIONS HUB Released a new Kount 360 Integration. This Integration makes it easy to integrate your Elastic Path store with Kount 360 for risk evaluation on carts. For details see Integrating with Kount 360.

MINOR Added support for the is_null search operator when searching for custom api entries.

MINOR Enhanced Date Parsing with Locale Support in PXM Product Import

We've added locale-aware date parsing to Product Template Date fields in PXM Product Import, reducing import failures and improving data accuracy by interpreting dates using region-specific formats.

What's New?

• Commerce Manager automatically detects your browser's locale and applies it to product import requests.
• API supports locale query parameter for en-US, en-GB, and en-CA date formats.
• Unsupported date formats fall back to default parsing, ensuring your imports continue to work.

See Product Import

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