Release Information
Upgrade Note: Before upgrading, review the release notes for every version between the current version and the target version to ensure no critical upgrade information is missed. Important upgrade information, including breaking changes, prerequisites, configuration updates, database changes, and deprecated features, is documented in the release in which it is introduced and may not be repeated in later release notes.
Version Note: To ensure the new feature functions as intended, using the latest version of the Storefront is recommended. Older versions may support the feature partially or could lead to limited functionality or operational inconsistencies.
What's New
Custom Promotion Type Configuration
Feature Overview
Administrators can now create and manage custom promotion types from Dev Center, providing greater flexibility in defining promotional structures without relying solely on predefined system promotion types.
This enhancement introduces configurable promotion-specific attributes and groups, allowing businesses to tailor promotion configurations to their unique requirements while maintaining compatibility with existing promotion functionality.
Key Features
- Added support for creating and managing custom promotion types from Dev Center → Promotion Settings.
- Removed the dependency on predefined promotion types by eliminating the Available Promotion Types field.
- Introduced Entity Sub Type support for Promotion Attributes and Groups, enabling configurations to be applied globally or to specific promotion types.
- Enabled creation of Global Attributes and Global Groups that are available across all promotion types.
- Enabled creation of Promotion Type-Specific Attributes and Groups that are displayed only for selected promotion types.
- Enhanced attribute-to-group association logic to consider both Entity Type and Entity Sub Type.
- Added validation to prevent duplicate promotion type class names.
- Added support for activating, deactivating, editing, and managing custom promotion types.
- Enhanced the Discount Type dropdown to display active custom promotion types alongside active system-defined promotion types.
- Introduced dynamic rendering of promotion attributes and groups based on the selected promotion type during promotion creation.
- Extended reporting and filtering capabilities to support custom promotion types.
- Preserved backward compatibility by automatically treating existing promotion attributes and groups as global configurations.
- Ensured existing promotions, pricing logic, APIs, and system-defined promotion types continue to function without disruption.
What's New
Discount Applicability on Handling Charges and Additional Product Pricing
Feature Overview
Introduced new configuration options that provide administrators with greater control over how discounts are calculated across shipping, promotions, and coupons.
Administrators can now independently determine whether shipping discounts should apply to handling charges and whether additional product pricing should be included in promotion, coupon, and voucher discount calculations. This enhancement helps merchants align discount behavior with their pricing and promotional strategies while preserving existing qualification, taxation, and order-processing rules.
Key Features
- Added a new Allow Shipping Discounts On Handling Charges setting under Global Settings → Promotion and Coupon Settings.
- Added a new Include Additional Product Pricing in Promotion, Coupon & Voucher Calculations setting under Global Settings → Global Product Settings.
- Enables administrators to control whether shipping discounts are calculated on shipping charges only or on the combined amount of shipping and handling charges.
- Enables administrators to control whether promotion, coupon, and voucher discounts are calculated on the base product price only or on the combined amount of the base product price and additional product pricing.
- Supports all major promotion types, including Product Promotions (excluding Bundled Product and Add-On Product promotions), Category Promotions, Catalog Promotions, Cart Promotions, Shipping Promotions, and Coupon-based discounts.
- Maintains promotion and coupon qualification logic independently from discount calculation logic, ensuring additional product pricing continues to contribute toward cart thresholds, minimum order values, and eligibility requirements.
- Applies configuration consistently across storefront orders, Admin-created orders, quotes, checkout, and Order APIs.
- Preserves existing promotion precedence, promotion stacking behavior, coupon validation rules, tax calculations, and handling charge calculations.
- Ensures excluded handling charges and additional product pricing remain non-discountable across all applicable promotions and coupons.
- Provides immediate effect upon saving configuration changes without requiring updates to existing promotions or coupons.
- Maintains full backward compatibility with existing orders, promotions, coupons, APIs, and historical transaction data.

Important Points
Z10-29996 | EPS File Extension Added to Allowed Attribute Configuration
Enhanced the Allowed Attribute configuration to support the EPS (Encapsulated PostScript) file extension across the platform. Administrators can now select and use EPS alongside existing supported file types when configuring File Attributes.
- Added support for the EPS file extension in Allowed Attribute configurations.
- Enables administrators to upload and manage EPS files through configured File Attributes.
- Validated support across DAM Media Attributes, Category Attributes, Product Attributes, and User Defined Attributes.
- Supports both existing file attributes and newly created file attributes.
- Enhanced import functionality to correctly process EPS file uploads.
- Maintains consistent file handling behavior across all supported attribute types.
- Preserves compatibility with all previously supported file extensions.

Z10-37672 | Parent SKU Available in Shipping Plugin Requests
Parent SKU information is now correctly bound and available within shipping plugin requests for configured products. This enhancement improves product identification and troubleshooting capabilities during shipping rate calculations and integrations.
- Added Parent SKU support in shipping plugin requests.
- Allows Parent SKU information to be traced through Application Logs.
- Supports Parent SKU tracking for the following product types:
- Configurable Products
- Simple Products
- Group Products
- Bundle Products
Black Box Improvements
PIM
Z10-39823 | Add to Cart Button Re-Enabled for Out-of-Stock Configurable Products
Corrected an issue where the Add to Cart button became active again after a PDP refresh for configurable products configured with Backorder status and unassigned inventory. Product availability validation has been improved to ensure the correct purchase state is maintained after page refreshes.
Z10-38879 | Inventory Count API Returns Incorrect Data
Corrected an issue where the /v2/publish-products/<sku>/inventory-count endpoint returned inaccurate inventory information. Inventory retrieval logic has been enhanced to provide accurate stock count data for integrated systems and downstream processes.
Z10-38095 | Product Publish Event Returns Incorrect Linked SKU Values
Corrected an issue where the Product Publish Event payload contained incorrect linked SKU values. Event generation logic has been updated to ensure associated product relationships are accurately included in published event data.
Z10-37179 | SEO-Friendly PLP Not Loading for Profile-Based Catalog Users
Corrected an issue where Product Listing Pages failed to load using configured SEO URLs for users associated with Profile-Based Catalogs. Routing and catalog resolution logic have been enhanced to ensure SEO-friendly URLs function correctly for all supported catalog configurations.
System Settings
Z10-40252 | Orders: Existing Unaltered Payment Displays as Payment Type Instead of Configured Display Name in Order Receipt
Corrected an issue where order receipts displayed the underlying payment type instead of the configured payment display name when an existing payment method remained unchanged. The order receipt has been enhanced to consistently show the admin-configured payment display name, providing a more accurate and user-friendly payment summary.
Z10-39955 | XML Sitemap Not Generated When Sitemap Type Is Set to "All"
Corrected an issue where XML sitemap generation failed when the sitemap type was configured as "All" and the product feed record count exceeded the actual number of products available in the catalog. Sitemap generation logic has been improved to accurately process catalog records and successfully generate the sitemap under all supported conditions.
Z10-38878 | Tax Details Missing in Avalara for Orders Requiring Approval
Corrected an issue where tax details were displayed in the webstore and admin for orders requiring approval, but the corresponding tax information was not available in the Avalara Sandbox. Tax synchronization has been improved to ensure tax records are properly created and accessible across integrated systems for approval-based orders.
Z10-35172 | Payment Display Name Not Reflected on Order Receipt After Update in Admin
Corrected an issue where updates made to payment display names in Storefront Payment Methods were not reflected on order receipts. The receipt generation process has been updated to display the latest configured payment display name, ensuring consistency between admin settings and customer-facing order documents.
Z10-39597 | Duplicate SKU Prevention During Product Imports
Resolved an issue where duplicate products with the same SKU could be created during ERP-driven product imports. The fix includes improvements to SKU validation logic and import processing controls to prevent duplicate SKU creation, including protection against concurrent import scenarios. Existing duplicate records were cleaned up, and the solution has been validated across both manual and API-based import processes.
Order Management System (OMS)
Z10-40156 | Checkout Order Class Remains Mapped to "In Progress" Status
Corrected an issue where the Checkout Order Class remained incorrectly mapped to the "In Progress" status on QA and Hotfix environments after configuration changes. Order status mapping logic has been improved to ensure the correct status association is consistently maintained across environments.
Z10-39956 | Shipping Address API Returns 403 Error for Customized Address
Corrected an issue where the Shipping Address API returned a 403 Forbidden response for customized shipping addresses. API validation and authorization handling have been enhanced to correctly process supported address customizations while maintaining security requirements.
Z10-39455 | Commerce API Shipping Methods Endpoint Returns 403 Response
Corrected an issue where the Commerce API used for retrieving shipping methods returned a 403 Forbidden response under valid request scenarios. API access validation has been updated to ensure eligible requests successfully return the available shipping methods.
Z10-39291 | Cart Quantity Cannot Be Edited After Merging Saved-for-Later Items
Corrected an issue where users encountered errors and were unable to modify cart quantities after merging Saved for Later items back into the shopping cart. Cart processing logic has been enhanced to correctly handle quantity updates after item merges.
Z10-39067 | Full Voucher Amount Not Applied When Order Includes Logo Cost
Corrected an issue where voucher discounts were not fully applied when an order included additional logo customization charges. Discount calculation logic has been enhanced to correctly apply the entire voucher value across all eligible order costs.
Z10-38824 | Quantity Not Updating on Cart Page
Corrected an issue where product quantity changes made on the cart page were not updating correctly. Cart update functionality has been improved to ensure quantity modifications are accurately reflected in both the cart and order totals.
Z10-38407 | Order Confirmation Email Sent but Order Not Created
Corrected an issue where order confirmation emails were successfully sent while the corresponding order was not created or visible in Znode, SPP, or NetSuite. Order processing and integration validation have been enhanced to ensure orders are successfully recorded before confirmation communications are issued.
Z10-37511 | CreatedDate and ModifiedDate Missing at Order Line Item Level
Corrected an issue where CreatedDate and ModifiedDate values were not available at the order line item level. The order data model and related APIs have been enhanced to include line-item-level creation and modification timestamps for improved tracking and auditing.
Content Management System (CMS)
Z10-40075 | Containers Page Displayed Twice in CMS Menu
Corrected an issue where the Containers page appeared twice within the Admin CMS navigation. Menu rendering logic has been updated to prevent duplicate entries and provide a cleaner navigation experience.
Z10-39453 | Widget Limit Validation Persists After Widget Deletion
Corrected an issue where the maximum widget limit validation message continued to appear even after widgets were removed from the page. Validation logic has been updated to immediately recalculate widget counts and display accurate validation messages.
Z10-39442 | Widget Limit Validation Message Lacked Impact Details
Enhanced the widget limit validation message to clearly explain the potential impact of exceeding the supported widget count. The improved messaging helps administrators better understand performance considerations and make informed configuration decisions.
Z10-38842 | Store Experience Primary CSS Variable Affects Page Builder Controls
Corrected an issue where the Store Experience primary CSS variable unintentionally impacted the styling of Page Builder admin controls. Style isolation has been improved to ensure storefront theme settings do not affect administrative interface elements.
POD_Marketing
Z10-39462 | Hydrated Search Displays Retail Price Instead of Sales Price
Corrected an issue where Hydrated Search displayed the retail price when the ERP returned a sales price value of $0.00. Pricing display logic has been enhanced to correctly evaluate returned pricing data and present the appropriate product price.
Z10-34492 | Attribute Display Order Not Returned Through API
Corrected an issue where configured attribute display order values were not being returned through the API. API response handling has been updated to preserve and return the defined attribute ordering for consistent storefront and integration behavior.
Accounts & Users
Z10-40098 | Unable to Login to Admin Portal
Corrected an issue where users were unable to log in to the Admin application. Authentication and environment configuration handling have been improved to ensure successful and reliable admin access.
DAM
Z10-39486 | Folder Search Not Working in DAM Media Upload Popup
Corrected an issue where folder searches within the DAM media upload popup did not return expected results. Search functionality has been enhanced to accurately locate folders and improve media management efficiency.
Z10-39460 | Unable to Select Multiple Images in DAM Gallery
Corrected an issue where users were unable to select multiple images in the DAM gallery and previously saved images were not displayed correctly. Gallery selection and image retrieval functionality have been improved to ensure a seamless media management experience.
Reporting
Z10-39816 | Top 3 Accounts Values Displayed as "$0bn"
Corrected an issue where sales values in the Top 3 Accounts section were displayed using a "$0bn" format, making actual sales figures difficult to interpret. Value formatting has been updated to present meaningful and readable sales amounts.
Z10-39815 | Missing Spacing in Sales and Account Name Tooltips
Corrected an issue where tooltip text in the Total Sales and Parent Account Name fields displayed without appropriate spacing. Tooltip formatting has been improved to enhance readability and user experience.
Z10-39814 | Top 3 Accounts Section Displays NA Accounts
Corrected an issue where accounts with unavailable or invalid data appeared in the Top 3 Accounts section. Report filtering logic has been enhanced to exclude non-applicable account records and improve reporting accuracy.
Z10-39743 | Amount Tooltip Not Displayed in Top 3 Accounts Report
Corrected an issue where tooltips were not displayed when hovering over account sales amounts in the Top 3 Accounts section. Tooltip functionality has been restored to provide users with detailed value information on demand.
Z10-39740 | User Name Displays NA Between First and Last Name
Corrected an issue where "NA" appeared between users' first and last names in the Top 3 Users by Total Sales report. Name formatting logic has been updated to display user information correctly and improve report readability.
Dev Center
Z10-37122 | Source Format Not Updating from CSV to JSON After Catalog Publish
Corrected an issue where the source format for a specific Data Exchange remained as CSV instead of updating to JSON after being triggered by a Catalog Publish event. Data Exchange processing has been enhanced to correctly apply and persist the configured source format during event execution.
Others
Z10-39803 | IsCommercial Field Not Updated Through UpdateAccountAddress API
Corrected an issue where updates to the IsCommercial field submitted through the WebStoreAccount/UpdateAccountAddress API were not being saved. API update processing has been enhanced to properly persist and reflect changes to commercial address settings.
Open-Source Enhancements & Fixes
Z10-39183 | Nested Sitemap Element Generated in Sitemap Index
Corrected an issue where generated sitemap indexes incorrectly contained nested <Sitemap> elements, resulting in invalid sitemap structure. Sitemap generation logic has been updated to produce standards-compliant sitemap indexes for improved search engine compatibility.
Z10-36811 | Login Error Displayed as "No Record Found"
Corrected an issue where users received a misleading "No record found" error message while attempting to log in to the store. Authentication error handling has been enhanced to properly process valid login requests and improve the user experience.
