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
Google Product Feed Support for Configurable Product Variant Grouping
Feature Overview
The Google Product Feed has been enhanced to correctly identify the relationship between a configurable parent product and its buyable variants. This allows Google to group different variants, such as color or size combinations, under a single product listing instead of treating them as separate products.
Key Features
- Each buyable child product (variant) submitted to the Google Product Feed now includes an
item_group_idthat references its configurable parent product. - The configurable parent product is excluded from the feed by default because it is not directly purchasable. An Admin setting is available to control whether the parent product should be included.
- The
item_group_idrelationship applies only to Configurable Products, where child products represent actual variants of the same product. - Group and Bundle Products are handled separately because their child products represent individual products rather than variants of the same product.
Full Text Search API Enhancements
Feature Overview
To improve storefront search experiences and support richer product filtering capabilities, the Full Text Search API has been enhanced with additional product metadata.
Key Features
Category Code in Search Results
- The Full Text Search API now returns the Category Code associated with each product.
- This allows storefront applications to use the returned Category Code as a filter parameter when retrieving category-specific product results.
Swatch Image Support
- The API now returns the swatch image path/URL for each product color variant.
- This enables storefronts to display color swatches directly within search results and product listings without requiring additional API calls.
Important Points
Clickable Product Links in Configurable Product Variants
The Configurable Product Variant experience has been enhanced to improve navigation and product management efficiency. Product names displayed in the Associated Product List are now clickable, allowing administrators to directly open the corresponding Manage Product page without manually searching for the product.
This enhancement streamlines product maintenance workflows and provides quicker access to product details while working with configurable product variants.
Performance Enhancements
Shipping Performance and Scalability Improvements
Implemented performance optimizations to improve the efficiency and responsiveness of shipping-related operations across the platform. Enhancements focused on streamlining shipping calculations, optimizing processing workflows, and improving overall system performance during checkout and shipping method retrieval.
Key Benefits
- Faster execution of shipping-related operations.
- Improved responsiveness when retrieving shipping methods.
- Reduced processing time during checkout.
- Enhanced system scalability for shipping workflows.
- Smoother and more reliable checkout experience.
Cart and Checkout Performance and Scalability Improvements
Implemented performance optimizations to improve the efficiency and responsiveness of Cart and Checkout operations across the platform. Enhancements focused on reducing processing overhead, optimizing data handling, and improving system performance for large and complex orders.
Key Benefits
- Faster Cart and Checkout processing.
- Improved application responsiveness during shopping and checkout.
- Reduced page load times and system latency.
- Enhanced scalability for high-volume order scenarios.
- Improved overall shopper experience and checkout reliability.
Login API Performance Optimization
Feature Overview
The Login API has been optimized to reduce redundant database calls executed during the user authentication process. Previously, user, role, and role-claim information was retrieved through multiple repetitive database queries, increasing API execution time and adding unnecessary load on the system.
The authentication workflow has been enhanced to streamline data retrieval, eliminate redundant queries, and improve overall login performance.
Key Benefits
- Reduces unnecessary database calls during user authentication.
- Improves Login API response times for a faster sign-in experience.
- Optimizes retrieval of user, role, and claim information.
- Reduces database load caused by repeated queries.
- Enhances application scalability under increased user traffic.
- Improves overall authentication efficiency and system performance.
Black Box Improvements
PIM
Z10-39406 | Unable to Delete Associated Products in Configurable Product Variants
Corrected an issue where administrators were unable to remove associated products from Configurable Product Variants. Additionally, the Product ID column was displayed as blank, making it difficult to identify associated records.
Product associations can now be removed successfully, and Product IDs are displayed correctly to improve variant management and product association visibility.
System Settings
Z10-39333 | Store-Associated Shipping Methods Are Not Loaded on Checkout After USPS Configuration Association
Corrected an issue where shipping methods associated with a store were not displayed on the Checkout page after a USPS shipping configuration was associated with the store.
Shoppers were unable to view eligible shipping options during checkout, which could prevent order completion. The shipping configuration logic has been updated to ensure that store-associated shipping methods load correctly and remain available during checkout.
Z10-39162 | Payment Options Missing After Updating Display Name
Corrected an issue where payment methods disappeared from the Checkout page after updating the display name of a payment option in the Admin Console.
As a result, shoppers were unable to select available payment methods and proceed with checkout. The payment configuration handling has been enhanced to ensure that payment options continue to display correctly after display name updates.
Content Management System (CMS)
Z10-38511 | Header Top Navigation Limited to 10 Pages and Delayed Publish Reflection
Resolved an issue where the CMS Header Top Navigation displayed only the first 10 configured pages, preventing additional navigation entries from appearing on the storefront.
Additionally, published navigation updates experienced significant delays before becoming visible. Navigation menus now correctly display all configured pages and published changes are reflected more efficiently.
Z10-38241 | Page Builder Continuously Loading for Complex Content Pages
Fixed an issue where the Page Builder remained in a continuous loading state when opening Content Pages containing a large number of containers.
Performance and loading behavior have been improved, allowing complex pages to open successfully and enabling administrators to manage content without interruption.
Order Management System (OMS)
Z10-38237 | Users Were Unable to Add Products to the Cart When the Product Included an Additional Cost
Resolved an issue that prevented products with configured additional costs from being successfully added to the cart.
The cart validation and pricing logic have been updated to correctly process products with supplemental charges during the add-to-cart workflow.
Z10-38237 | Cart Subtotal Shows Retail Price Instead of $0 When Product Has Sales Price = $0
Corrected an issue where the cart subtotal displayed the product's retail price instead of $0 when a product was configured with custom pricing and a sales price of $0.
This resulted in inaccurate pricing information being shown in the shopping cart. The cart calculation and display logic have been updated to correctly reflect a subtotal of $0 when the configured sales price is $0.
Z10-28107 | Zero-Priced Product Order Placement After Price List Removal
Resolved an issue where users were able to place orders for products with a zero price after the products had been removed from the assigned Price List.
Product pricing validation has been enhanced to prevent checkout and order placement for products that no longer have an applicable price, ensuring pricing accuracy and order integrity.
Z10-39466 | Cart/Checkout Order State Updated from INPROGRESS to ACTIVE
Resolved a breaking change where the order state used during Cart and Checkout processing was changed from INPROGRESS to ACTIVE.
This update caused automation failures and integration issues for implementations relying on the previous status value. Order workflow processing has been aligned to support the new ACTIVE status while ensuring consistent order state behavior across OMS operations.
Z10-38088 | Tax Exempt and Tax Amount Updated Incorrectly During Order Status Changes
Corrected an issue where changing an order status from Submitted to In Progress unintentionally modified the Tax Exempt flag and recalculated tax amounts.
The order management process has been enhanced to preserve tax-related information during status transitions, ensuring accurate taxation and order totals throughout the order lifecycle.
Marketing
Z10-38890 | Default "Sort By" Option Not Displayed Correctly on PLP
Corrected an issue where the default Sort By option was not displayed correctly on the Product Listing Page (PLP), causing confusion when viewing and sorting product results.
The sorting functionality has been updated to properly display the configured default sorting option, providing a more consistent and intuitive product browsing experience.
Accounts & Users
Z10-39036 | Password Reset Failure After Upgrade
Resolved an issue where password reset functionality continued to fail after upgrading the application. Users were unable to successfully reset their passwords despite the upgrade implementation.
Password reset operations now complete successfully and return the expected results, ensuring reliable account recovery.
Z10-38898 | Blank Checkout Page When User Shipping Address Suggestion is Enabled
Fixed an issue where a blank page was displayed during checkout when the EnableUserShippingAddressSuggestion setting was enabled.
The checkout workflow has been corrected to load successfully while continuing to provide shipping address suggestions as configured.
Z10-38896 | Account Code/External ID Disappears After Address Update
Resolved an issue where the Account Code/External ID value disappeared from the Address List after editing and saving an address.
Address updates now preserve the associated Account Code/External ID, ensuring customer account information remains visible and consistent.
Z10-31180 | FEDEX_GROUND Shipping Method Not Displayed During Checkout
Corrected an issue where the FEDEX_GROUND shipping method did not appear on the checkout page even after being properly associated with a store.
Shipping methods are now displayed correctly during checkout, allowing customers to select the configured FedEx Ground delivery option.
Others
Z10-39499 | AddonGroup/CreateAddonGroup API Missing Case-Sensitive Validation
Corrected an issue where the AddonGroup/CreateAddonGroup API did not properly validate records based on case-sensitive values.
This could allow the creation of duplicate or inconsistent add-on groups with similar names differing only by letter casing. The API has been enhanced to perform appropriate validation checks and maintain data consistency.
Z10-39083 | Functional Issues in Address v2.1 APIs
Resolved multiple functional issues within the Address v2.1 APIs, including request validation gaps, incorrect response field mappings, inconsistent HTTP status code handling, and issues related to processing identical address payloads.
The APIs have been enhanced to provide accurate validation, consistent responses, and reliable behavior across address management operations.
Z10-38150 | IsGuestUser Flag Incorrectly Returns False for Guest Users in CP Class Details API
Corrected an issue where the IsGuestUser flag in the CP Class Details API incorrectly returned false for guest users.
This behavior could lead to incorrect identification of guest users by integrations or custom implementations consuming the API. The API response has been updated to return the correct IsGuestUser value, ensuring accurate guest user identification.