Release Information

The Znode 10.13.0.0 release introduces new features, enhancements, performance upgrades, and bug fixes across multiple areas of the platform.

Version Note: To ensure new features function as intended, using the latest version of the Storefront is recommended. Older versions may support features only partially and could result in limited functionality or operational inconsistencies.

Release Highlights

New Features & Enhancements

Area	Highlights
Marketing	Added a Promotion Extensibility Framework to create and manage custom promotion types without modifying the core application.
Order Management (OMS)	Approval workflows now evaluate Order Subtotal only, excluding taxes, shipping, discounts, and other charges.
DAM	Added 400-character media path validation with logging for skipped media records.
SDK/Webstore	Added Webstore Version Visibility through package.json and the /api/health-check endpoint.
SEO	Improved crawlability, indexing, 404 handling, pagination, and server-rendered SEO content across storefront pages.
Email Templates	Added support for the #Image# macro to display product images in order-related email templates.
Performance	Improved configurable product variant selection and optimized storefront page load and rendering performance.

Other Improvements

Area	Highlights
PIM	Improved catalog publishing and termination handling, enhanced product and category search accuracy, fixed SKU validation messaging, corrected add-on pricing display, improved inventory visibility, resolved tab-loading issues, and enhanced indexing progress updates.
System Settings	Improved shipping method and rate handling, strengthened Centralized Login import validations, standardized delivery date formats, enhanced export functionality for promotions and vouchers, prevented duplicate address creation, and improved import log readability.
Dev Center	Enhanced Data Exchange token handling, improved Custom Table import validation and API sorting, corrected field management behavior, restored log visibility in Admin, and improved overall platform reliability.
Marketing	Strengthened Search Profile validation, improved searchable field persistence, and restored Sitemap XML accessibility when Login Required is enabled.
CMS	Improved validation messaging and Display Order controls, restored CMS page editing functionality, optimized storefront stylesheet loading, and enhanced Product Feed configuration validation.
Accounts & Users	Improved centralized login workflows, corrected validation messaging, enhanced guest user management, resolved CAPTCHA-related account creation failures, and fixed approval routing permission validation.
OMS	Improved BOGO promotion calculations, corrected cart and checkout total calculations, enhanced quote creation and expiration handling, improved coupon generation validation, fixed voucher application logic, and restored product image rendering in order emails.
DAM	Restored product image visibility in carousel associations, fixed image generation functionality, and improved Published Brands API performance.
Stores	Restored Add to Cart functionality in Product Carousels, improved guest checkout redirection behavior, and corrected storefront stock-level display calculations.
APIs & Integrations	Improved user account pagination, strengthened user creation validation, normalized SKU values, synchronized category search results across APIs and storefront, enhanced category filtering APIs, and improved bulk quantity processing reliability.
Open-Source Fixes	Enhanced Admin Dashboard usability, UI consistency, visual layout, and overall user experience.

Disclaimer

Display Order Field Removal from Category (Admin UI Only)

This change is limited to the Admin UI only. The Display Order field has been hidden from the Category Listing, Add New Category, and Manage Category forms, and the DisplayOrderCategory attribute has been removed from the Category Attribute List. No changes have been made to the underlying APIs or business logic. Existing APIs continue to support the Display Order value and will function as per their current behavior.

Enable XSS Validation

Even if the Enable XSS Validation and Enable IDOR Validation flags are set to true, the changes will only take effect after explicitly saving the configuration.

Disable SEO Validation

Even if the Disable SEO Validation flag is set to true, the changes will only take effect after explicitly saving the configuration.

Temporary Disablement of Email Marketing Tab

The Email Marketing tab within the Stores section has been temporarily disabled to accommodate ongoing updates and improvements. During this period, Admin users will not have access to email marketing features from the Stores section. Functionality will be restored once the necessary changes have been completed and validated.

Temporary Disablement of Promotions, Coupons, and Vouchers Management on the Manage Order Screen (Continued from Previous Version)

In this release, the ability to add, manage, or modify promotions, coupons, and vouchers has been temporarily disabled on the Manage Order screen in the Admin Console. While promotions and coupons applied during order creation remain visible, the options to add new promotions or remove existing ones are unavailable. This functionality will be re-enabled in a future update.

Promotion Extensibility Framework

What's New

Introduced a new Promotion Extensibility Framework that enables organizations to create, deploy, and manage custom promotion types without modifying the core Znode application.

Feature Overview

This enhancement provides a scalable and upgrade-safe approach for extending promotion functionality through custom promotion extensions. Businesses can implement unique promotional scenarios such as customer-specific, loyalty, membership, brand, category, coupon, and cart-based promotions while maintaining compatibility with future upgrades.

Custom promotions can be developed as independent extensions and managed through the Znode Extension Framework. Administrators can create and maintain custom promotion types from the Promotion Settings section under Dev Center, including configuring activation status and managing promotion type definitions. Active custom promotion types are automatically available in the Discount Type dropdown during promotion creation, allowing merchants to manage custom promotional campaigns through the standard Promotion Management experience.

The framework also supports independent deployment, versioning, lifecycle management, enhanced monitoring capabilities, and comprehensive developer guidance for extension creation, configuration, execution, and troubleshooting.

Deprecation

The Available Promotion Types field has been deprecated and removed from the Add Promotion Type screen.

---

Approval Workflow Threshold Evaluation Uses Order Subtotal

What's New

Approval workflows now evaluate the Order Subtotal when determining whether an order requires approval and identifying the applicable approval level.

Feature Overview

The Set Approval for Orders Above ($) configuration now evaluates only the Order Subtotal for both Single-Level and Multi-Level approval workflows. Taxes, shipping charges, handling fees, discounts, and other order-level adjustments are excluded from the approval threshold calculation.

This change ensures more accurate and consistent approval routing by aligning approval decisions with the configured subtotal threshold rather than the final order total.

Example:

• Configured Approval Threshold: $1,000
• Order Subtotal: $900
• Shipping Charges: $50
• Taxes: $100
• Order Total: $1,050

Since the approval evaluation is based solely on the $900 Order Subtotal, the order does not require approval, even though the Order Total exceeds the configured threshold.

Enhancement – Media Path Length Validation

What's New

To maintain data integrity and ensure compatibility during media processing, Znode now enforces a maximum media path length of 400 characters across all supported media types, including Internal Media, External Media, and Full URL media.

Feature Overview

During media insertion, update, or synchronization, Znode validates the length of the media path before processing the media asset. Media records with a path length of 400 characters or fewer are processed successfully.

If a media asset exceeds the supported 400-character limit, Znode automatically skips the record during synchronization to prevent unsupported media paths from being stored and to avoid potential processing or database-related issues.

Whenever a media record is skipped due to an excessive path length, an entry is generated in the Application Logs, allowing administrators to review the affected record, identify the issue, and take appropriate corrective action before reattempting synchronization.

---

SDK Version Visibility Enhancement

What's New

Added Webstore Version Visibility to help quickly identify the currently deployed storefront version.

Feature Overview

This enhancement provides a consistent way to verify the Webstore version across environments. Users can confirm the deployed version by checking the version field in the package.json file within the codebase or by accessing the /api/health-check endpoint, which displays the version currently running in the deployed environment.

This improvement simplifies troubleshooting, validation, deployment verification, and support activities.

---

SEO Improvements

What's New

Enhanced the storefront's SEO foundation with improvements focused on crawlability, indexability, content discoverability, and user experience. Invalid URLs across Brand, Blog, Product Listing Pages (PLP), Product Details Pages (PDP), Content Pages, and SEO Pages now return the correct 404 (Not Found) response, helping prevent invalid pages from being indexed by search engines.

SEO-critical pages have been optimized to ensure content is available in the initial HTML response, enabling search engines to access and index content without relying on JavaScript execution. Additional enhancements include improved category navigation, SEO-friendly pagination, and optimized Brand Details pages.

Feature Overview

These enhancements improve how search engines discover, crawl, and index storefront content while maintaining a seamless user experience. By delivering content and key navigation elements in the initial page response, Znode provides a more search-engine-friendly storefront aligned with modern SEO best practices.

• Improved 404 handling for invalid pages.
• Server-rendered content support for SEO-critical pages.
• Enhanced category navigation with crawlable first-level category links.
• SEO-friendly pagination for improved content discovery.
• Optimized Brand Details pages to expose brand and product content in the initial response.

Collectively, these improvements strengthen internal linking, enhance content accessibility, improve crawl efficiency, and increase the visibility of storefront content in search engine results.

---

Image Macro Support in Order-Related Email Templates

What's New

Enhanced support for the #Image# email macro in order-related email templates. The #Image# macro is included in supported email templates and is now processed correctly to return the product image path, enabling customers to display product images in email notifications.

Important: To display product images in supported email templates, customers must update the template source code to wrap the #Image# macro within an HTML <img> tag.

Feature Overview

The #Image# macro path is supported in the following email templates:

• OrderPlacedNotification
• CancelledOrderReceipt
• PendingOrderApproval
• QuoteConvertedToOrderNotificationForCustomer
• QuoteRequestAcknowledgementNotificationForCustomer
• ResendOrderReceipt
• ReturnRequestNotificationForCustomer
• ShippingReceipt
• SendWaitingListNoticeInInventory

With this enhancement, the macro now returns the product image path. Customers using existing templates containing the #Image# macro should review and update their templates to ensure product images render correctly.

Guidelines

• The #Image# macro returns only the product image path (URL).
• To render the actual product image, the macro must be wrapped within an HTML <img> tag.
• Customers should review and update existing templates containing the #Image# macro after upgrading.

Example:

<img src="#Image#" alt="" width="60"
style="display:block; width:60px; max-width:100%;
height:auto; border:0; outline:none; margin:0 auto;">

Performance Enhancements

Performance Enhancement for Configurable Product Variant Selection

Implemented performance optimizations to improve responsiveness when shoppers interact with configurable products, resulting in a smoother and faster product selection experience.

Key Enhancements

• Improved the performance of configurable product variant selection.
• Reduced delays when switching between product variants such as size, color, or style options.
• Enhanced storefront responsiveness to provide a faster and more seamless shopping experience.

Storefront Performance Improvements

Implemented targeted performance improvements to optimize storefront page rendering and reduce load times, delivering a faster and more responsive browsing experience.

Key Enhancements

• Reduced page load and rendering delays that previously reached up to 10 seconds.
• Improved overall storefront responsiveness and user experience across key shopping workflows.

Black Box Improvements

Product Information Management (PIM)

Z10-15382 | Product Tabs Display Mixed Data

Corrected an issue where data from multiple product tabs appeared together when users rapidly switched between tabs. Tab content now loads independently to prevent overlapping or incorrect information.

Z10-28548 | Catalog Page Console Errors and Excessive Network Calls

Corrected performance issues on the Catalogs page that generated console errors and unnecessary network requests. The page now loads more efficiently with improved stability and responsiveness.

Z10-29335 | Incorrect SKU Validation Message

Corrected an issue where an incorrect validation message displayed when invalid special characters were entered in the SKU field. Validation feedback now accurately reflects the input error. Updated the SKU validation message to clearly specify the supported alphanumeric and special characters.

Z10-30339 | Catalog Publish Stuck and Termination Timeout

Corrected an issue where catalog publishing became stuck and manual termination actions timed out. Publishing processes can now be stopped successfully and status updates are handled correctly.

Z10-31933 | Site Search Index Progress Not Visible Until Refresh

Corrected an issue where the PIM index progress bar and associated job status did not update until the page was refreshed. Real-time progress visibility has been improved for indexing operations.

Z10-33809 | Override Catalog Publish Cannot Be Terminated

Corrected an issue where override catalog publish operations continued running even after users selected the terminate action. Publish termination requests are now processed successfully.

Z10-35735 | Category Page Infinite Loading After Search Reset

Corrected an issue where clearing the product search on the Admin Category page caused an endless loading state. Search results now reset correctly without affecting page functionality.

Z10-36079 | Add-On Product Prices Display Blank

Corrected an issue where add-on product prices appeared blank and only displayed the “+” symbol when the parent product had no price. Price values are now displayed correctly across add-on selections.

Z10-36143 | Category Names Containing Commas Not Searchable

Corrected an issue preventing category names containing commas from appearing in Admin search results. Search functionality now properly supports category titles with special punctuation.

Z10-36479 | Products with Null Inventory Showing Incorrect Stock Status

Corrected an issue where products with null inventory values appeared out of stock on the PDP despite being purchasable from other areas. Inventory handling has been updated for more consistent stock visibility.

Fixed the issue for Wishlist page and observed that the View Details button appears for Simple, Configurable, Bundle, and Grouped products when the Out-of-Stock (OOS) setting is configured as Allow back-ordering of products and the product has no inventory.

Z10-36546 | Replacement Hyperlink Redirect Issue on PDP

Corrected an issue where clicking the “Replacement” hyperlink briefly navigated to the target section before returning users to the top of the page. The link now consistently navigates to the intended content. Clicking the "Replacement" hyperlink scrolls to the target section and remains in the Replacement Product Suggestions section.

Z10-36699 | Product Global Search Filtering Limitations

Corrected limitations within Product Global Search affecting searches by product name, product code, and SKU. Search behavior has been improved to return more accurate and comprehensive results.

System Settings

Z10-19901 | Deleted FedEx Shipping Rates Still Displayed

Corrected an issue where FedEx shipping rates continued appearing in checkout summaries after the shipping option was deleted. Shipping calculations now reflect current shipping method configurations.

Z10-33103 | Global Settings Validation Message Misalignment

Corrected UI alignment issues affecting validation messages within the Custom Table Settings tab. Validation feedback now displays consistently alongside the relevant fields.

Z10-34731 | Deleted Shipping Methods Still Applied in Checkout

Corrected an issue where removed shipping methods remained applied in quote and checkout summaries. Shipping selections now refresh correctly when shipping methods are deleted.

Z10-35650 | Shipping Rates Displayed When Disabled

Corrected an issue where shipping rates continued displaying in checkout summaries even when Shipping Display Settings were disabled. Display rules are now honored consistently. Shipping methods and rates no longer appear on checkout or quote summaries when Shipping Display Settings is disabled.

Z10-35852 | Customer Re-Import Failure With Centralized Login

Corrected an issue where customer re-import operations failed for exempt stores when Centralized Login was enabled. Import processing now handles exempt store scenarios correctly.

Z10-35981 | Invalid Default Store Allowed During User Import

Corrected an issue where imports permitted new users to be assigned invalid default stores while Centralized Login was enabled. Store validation has been strengthened during import processing.

Z10-36120 | Duplicate Addresses Created Through TradeCentric Sessions

Corrected an issue where multiple TradeCentric PunchOut sessions created duplicate address records for the same user. Address management has been improved to prevent duplicate entries.

Z10-36236 | Inconsistent Shipping Method Delivery Date Formats

Corrected inconsistencies in delivery date formatting across shipping carriers. Delivery dates are now displayed in a unified format for a more consistent user experience.

Z10-36332 | Missing Call for Price Value in Promotion Export

Corrected an issue where the Call for Price message value was omitted from exported promotion CSV files. The export process now includes the expected data.

Removed the Call for Price Message implementation from both the UI and the import process. The data is now mapped exclusively to the Promotion Message field.

Z10-36349 | Invalid Origin Address in Shipping Plugin Request

Corrected an issue where invalid origin address details were included in shipping plugin requests. Shipping payload generation has been updated to provide accurate address information. Shipping methods are rendered correctly on checkout and quote pages.

Z10-36377 | Voucher Export Process Not Starting

Corrected an issue preventing voucher exports from initiating within the User Vouchers section. Export functionality now starts and completes as expected.

Z10-36491 | Voucher Export Included Unconfigured Attributes

Corrected an issue where voucher exports included additional attribute columns that were not configured for export. Export files now contain only the selected attributes.

Z10-36617 | Promotion Export Included Unassociated Attributes

Corrected an issue where promotion export files included unassociated additional attribute columns. Exported data is now limited to the attributes configured for export.

Z10-36896 | Import Log Details Text Not Wrapping

Corrected an issue where long field values in Import Log Details did not wrap correctly and impacted readability. Content now displays properly within the available layout.

Dev Center

Z10-28156 | Token Expired Error in Commerce Connector Data Exchanges

Corrected an issue where Data Exchange operations displayed token-expired errors despite valid authentication. Token handling and session management have improved.

Z10-33514 | Incorrect Delete Message in Manage Fields

Corrected an issue where the message “Item cannot be deleted” appeared when attempting to remove an unsaved field. Validation now correctly reflects field state and available actions.

Z10-35208 | Custom Table Import Precision Error

Corrected an issue where custom table imports failed with database errors when numeric values exceeded configured precision and scale limits. Import validation has been improved to handle these scenarios appropriately.

Z10-36014 | Failed to Create Error After Boolean or Date Field

Corrected an issue where adding new fields after Boolean or Date & Time fields triggered a misleading “Failed to Create” error. Field creation now works as expected.

Z10-36897 | Newly Added Logs Not Visible in Admin

Corrected an issue preventing newly generated Znode logs from appearing within the Admin interface. Log visibility has been restored for easier troubleshooting.

Z10-37070 | Incorrect Sorting for Size Column in Custom Table Data API

Corrected an issue where sorting on the Size column returned inaccurate results. The API now sorts values correctly based on the underlying data.

Marketing

Z10-35755 | Search Profile Validation and Field Persistence Issues

Corrected issues where Boost Value validation did not consistently enforce the supported range and deleted searchable fields reappeared after save failures. Validation and save behavior have been improved.

Boost Value validation now consistently enforces a 1–999 range and prevents invalid saves. Deleted searchable fields do not reappear after save failures.

Z10-36492 | Sitemap XML Not Accessible With Login Required Enabled

Corrected an issue preventing access to the store sitemap XML when the Login Required setting was enabled. Sitemap availability has been restored while maintaining intended access controls.

Content Management System (CMS)

Z10-35463 | Product Feed Validation Message Misalignment

Corrected an issue where the Product Feed Record Count validation message was not properly aligned with its input field. Validation feedback now displays consistently within the UI.

Z10-35538 | Invalid Display Order Values Accepted

Corrected an issue where Display Order fields accepted invalid values, including negative and non-numeric entries. Validation now enforces valid numeric inputs across supported widgets.

The Display Order field no longer accepts invalid values across Category, Product, Brand, and Carousel widgets.

Z10-35896 | Unable to Modify UTS CMS Pages

Corrected an issue preventing users from making changes to UTS CMS pages. CMS editing and saving functionality have been restored.

Z10-36574 | Duplicate CSS Stylesheet References

Corrected an issue where duplicate stylesheet links were included in production storefront pages. CSS loading has been optimized to improve performance and reduce redundancy.

Accounts & Users

Z10-33753 | Leave Site Prompt Appears When Changing Store

Corrected an issue where centralized users encountered an unnecessary browser “Leave Site?” prompt when changing stores on the Carts tab. Store switching now functions without interruption.

Z10-33787 | Incorrect Centralized Login Validation Message

Corrected an issue where user creation displayed an incorrect validation message when Restrict was enabled under Centralized Login. Validation messaging now accurately reflects configuration requirements.

Z10-34876 | Guest User Save Fails on First Attempt

Corrected an issue where new or unmanaged guest users could not be saved successfully on the first attempt. Validation and save processing have been improved.

Field-level validation messages are now displayed correctly when attempting to save a guest user without providing a username.

Z10-36476 | Account Creation Fails Due to CAPTCHA Error

Corrected an issue where shoppers could not create accounts during checkout because of CAPTCHA verification errors. Account registration now completes successfully when valid CAPTCHA responses are provided.

Z10-36677 | Approval Routing User Permissions API Error

Corrected an issue where the User Permissions API incorrectly returned permission-related errors during approval routing creation. Permission validation now functions as intended.

Order Management System (OMS)

Z10-34052 | BOGO Discount Applied to Incorrect Product

Corrected an issue where BOGO percentage discounts were applied to unintended products. Promotion calculations now correctly identify eligible discounted products.

Z10-34425 | BOGO Higher-Priced Product Discount Issue

Corrected an issue where BOGO promotions incorrectly discounted higher-priced products when Buy and Get product groups differed. Discount calculations now follow configured promotion rules.

Z10-35797 | Cart and Checkout Total Mismatch

Corrected an issue causing total discrepancies between Cart and Checkout due to duplicate logo additional-cost calculations. Totals are now calculated consistently across the checkout journey.

Additional Cost charges are reflected correctly in Cart and Checkout totals in both GET APIs. When the same Code is passed multiple times in the AdditionalCost collection, all entries are treated as separate charges.

Z10-35914 | Quote Created Despite Unsuccessful API Response

Corrected an issue where quote records were created even when the API returned an unsuccessful response. Quote creation and response handling are now properly synchronized.

Z10-35954 | Copied Quote Displays Incorrect User Email

Corrected an issue where copied quotes displayed the Admin user's email instead of the selected target user's email. Quote ownership details now display correctly.

Z10-36150 | Missing Quantity Validation During Coupon Generation

Corrected an issue where no validation message appeared when the Initial Quantity exceeded the supported limit during coupon generation. Users now receive clear validation feedback.

Z10-36198 | Convert to Order Disabled Before Quote Expiration

Corrected an issue where active quotes became unavailable for conversion before reaching their expiration date. Eligible quotes can now be converted to orders as expected.

Updated the scheduler logic to mark quotes as Expired when the Expiration Date is less than or equal to the current date, comparing only the date and ignoring the time component. This ensures consistent behavior between the Admin application and the Storefront.

Z10-36329 | Voucher Not Covering Full Order Amount

Corrected an issue where automatically applied vouchers failed to cover the full order amount even when sufficient voucher balance was available. Voucher calculations now deduct the expected amount.

Z10-36480 | Address Line 2 Missing on Return Receipt

Corrected an issue where Address Line 2 was not displayed within the Shipping To section of return order receipts. Complete address information is now included.

DAM

Z10-35532 | Product Images Missing in Carousel Association Modal

Corrected an issue where product images were not displayed within the Product Carousel association modal. Image rendering has been restored for improved product selection.

Z10-36084 | Generate Image Button Not Working

Corrected an issue where the Generate Image button stopped functioning after modifying image pixel settings within Media configuration. Image generation now works as expected.

Z10-36443 | Published Brands API Performance Improvement

Corrected a performance issue where the Published Brands API required over 10 seconds to respond, causing delays on brand pages. Response times have been optimized for faster page loads.

Stores

Z10-32981 | Add to Cart Missing in Product Carousel

Corrected an issue where the Add to Cart button was not displayed within Product Carousel widgets on the storefront, even when the feature was enabled through Store Settings. The carousel component now consistently honors store-level configuration settings and displays the Add to Cart option wherever applicable.

Z10-35926 | Guest Checkout Redirects to Wrong Page

Corrected an issue where shoppers selecting Checkout as Guest were incorrectly redirected to the storefront Home page when the Login to See Pricing & Inventory setting was enabled. The checkout experience now correctly redirects shoppers to the Login page whenever authentication is required.

Z10-35985 | Stock Level Display Setting Not Working

Corrected an issue where the Display Stock Levels from Default and All Warehouses setting was not functioning correctly, resulting in inaccurate inventory visibility. Inventory display logic now respects store configuration settings and accurately reflects available stock levels.

Open-Source Enhancements and Fixes

Z10-33159 | Admin Dashboard UI Improvements

Corrected UI issues affecting the Admin Dashboard experience. Layout and visual behavior have been refined to improve usability and consistency.