DocumentationCommerceCatalog Service

Commerce Storefront Catalog Service Release Notes

Last update: May 11, 2026

CREATED FOR:

  • Admin

These release notes cover the latest Commerce Catalog Service updates, including:

NOTE
If your Commerce project uses Adobe Commerce Optimizer to deliver catalog data to Commerce Edge Delivery Service or headless storefronts, see the Adobe Commerce Optimizer release notes for the latest API updates.

Updates are categorized by type:

New New features
Fix Fixes and improvements
Bug Known issues

Support is provided for the latest version. Release notes for older versions are included for reference.

Storefront Catalog Service

May 2026

Release date: May 13, 2026

New Category sort order in GraphQL—The CategoryView GraphQL type now includes a position field, so storefronts can display categories in the order merchants configure in the catalog hierarchy.

Release date: May 4, 2026

Fix Storefront product prices now display the correct currency code (for example, USD) for all product types. Previously, some products showed NONE instead of the expected currency, resulting in missing prices. This update ensures consistent and accurate price rendering across the storefront.

April 2026

Release date: April 29, 2026

New Enforced limit of maximum 100 SKUs per request for Adobe Commerce Optimizer and Adobe Commerce as a Cloud Service
clients as per documented limits and boundaries.

Release date: April 17, 2026

New Added a new searchCategory GraphQL query that enables clients to search categories by name with paginated results. The query accepts a required searchTerm (minimum 3 characters) and optional family, pageSize, and currentPage parameters. Results include matching CategoryTreeView objects with full category metadata, a totalCount, and pageInfo for pagination.

This query is available only for customers using Adobe Commerce Optimizer Merchandising Services. See searchCategory.

March 2026

Release date: March 24, 2026

New Added support to compute and return the price range for dynamic bundles.

December 2025

Release date: December 11, 2025

Fix System-level and infrastructure improvements to enhance performance and stability.

November 2025

Release date: November 17, 2025

New Attribute Filtering by Name–The productSearch GraphQL query now supports filtering product attributes with the names field. With this filter, you can:

  • Reduce response payload size by requesting only specific attributes

  • Combine with the existing roles filter to narrow by visibility role and attribute name

  • Examples:

    Filter by attribute names only

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(names: ["color", "size", "material"]) {
      name
      label
      value
    }
  }
}

    Filter by both roles and names:

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
      name
      label
      value
      roles
    }
  }
}
NOTE
To retrieve all attributes without filtering, omit the names argument or provide an empty array.

Release date: November 6, 2025

Fix System-level and infrastructure improvements to enhance performance and stability.

Fix Grouped products can now be queried when the parent has no pricing; child products return their own visibility roles.

Fix System-level and infrastructure improvements to enhance performance and stability.

September 2025

Release date: September 8, 2025

New Added Tier Pricing support to query volume pricing:

To retrieve tier pricing:

  1. Use the products query with your desired SKUs
  2. For SimpleProductView, access price.tiers
  3. For ComplexProductView, access priceRange.minimum.tiers and priceRange.maximum.tiers
  4. Each tier contains the discounted tier price and quantity conditions
  5. Define quantity thresholds with gte (greater than or equal to) and lt (less than)

Example:

query {
  products(skus: ["SKU-001"]) {
    ... on SimpleProductView {
      price {
        regular { amount { value currency } }
        tiers {
          tier { amount { value currency } }
          quantity {
            ... on ProductViewTierRangeCondition { gte lt }
          }
        }
      }
    }
  }
}

Fix Tier prices filtered by minimum final price

The API now returns only tiers whose discounted price is lower than the product’s minimum final price. Higher tiers are omitted because the minimum final price would apply on the storefront instead.

Applies to:

  • Simple products: price.tiers only includes tiers with tier.amount.value < price.final.amount.value (minimum final).
  • Complex products: priceRange.minimum.tiers and priceRange.maximum.tiers use the same rule when building the price range.

Release date: September 2, 2025

Fix Improved error handling for missing price information—When price data is not yet received, the API returns null for the price field instead of throwing an error, allowing clients to handle missing data gracefully.

Fix System-level and infrastructure improvements to enhance performance and stability.

July 2025

Release date: July 30, 2025

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

Release date: July 24, 2025

New Retrieve recommendation units by unit ID–New GraphQL endpoint recommendationsByUnitIds retrieves recommendation units by their unique ID for more flexible, targeted access.

  • unitIds is required (list of recIds to fetch).

  • Context parameters (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) behave the same as in the existing recommendations query.

  • Example

    code language-graphql 
    query {
  recommendationsByUnitIds(
    unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"]
    currentSku: "24-MB01"
    cartSkus: ["24-MB01"]
  ) {
    totalResults
    results {
      unitId
      unitName
      totalProducts
      productsView {
        sku
      }
      pageType
      typeId
      storefrontLabel
      displayOrder
    }
  }
}

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

Release date: July 15, 2025

New Gift card product types–Catalog Storefront Service now supports product attributes as JSON objects or arrays, enabling flexible management of complex types such as gift cards.

Previous versions

June 2025

Release date: June 20, 2025

New Hierarchical price book configuration—Accurate price ranges for parent-child price books. Calculations respect hierarchy and inherited rules; reduces pricing errors when multiple price books are linked. Adobe Commerce Optimizer only. See Price Books.

New Case-insensitive keys—Key lookups in queries are now case-insensitive, reducing errors from key casing.

Release date: June 20, 2025

New Public IO Events for Catalog Storefront—Added public IO events for real-time integration and observability (CSS and EDS).

New Server-Side Rendering (SSR)—Architectural improvements to support SSR for better performance, SEO, and UX on large catalogs.

New Infrastructure & Security—New AWS roles, ServiceNow integration, and CI/CD pipelines for the events service.

New Event formats & observability—Streamlined payloads, enhanced monitoring, improved variant event data.

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

Release date: June 13, 2025

New Retrieve uncached data–Enable the Magento-Is-Preview header to pass uncached data from the catalog endpoint to the Search Service.

New Multi-select product options–GraphQL API now exposes whether product options allow multiple selections (for example, bundle “choose multiple items”).

New Updated price validation on data ingestion to support products without prices.

Fix Improved error handling for simple bundle pricing in Adobe Commerce Optimizer.

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

April 2025

Release date: April 8, 2025

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

Fix Infrastructure now supports extremely large catalogs (up to ~440 million SKUs) without impacting existing workloads.

March 2025

Release date: March 28, 2025

Fix Attributes without roles are no longer indexed by default for the composable catalog, improving indexing time and reducing storage. Legacy behavior can be re-enabled via a feature flag.

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

February 2025

Release date: February 18, 2025

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

December 2024

Release date: December 9, 2024

Major release: composable catalog data model for headless storefronts, header management, and product data handling.

New Composable Catalog Data Model (CCDM)—Supports customers using the composable catalog for headless storefronts. New endpoints accept Catalog View and Policy IDs (backward compatible). Configurable product details and prices with built-in pagination.

New Header Management–AC-Locale renamed to AC-Scope-Locale for composable catalog API operations; header mapping and default values specified.

New Product Data & Pricing–Support for composable catalog data model and improved price handling for configurable products.

CurrencyEnum updated to support NONE for product search queries, aligning with federation logic.

Fix Infrastructure & upgrades—System-level improvements for security, performance, and stability.

Fix Bundle product options now display only enabled products.

Release date: December 9, 2024

New Image ordering in product queries—Product images in the GraphQL images field now follow catalog export sortOrder for consistent storefront and API behavior.

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

Release date: December 2024

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

October 2024

Release date: October 22, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New GraphQL schema now includes lastModifiedAt in product information for accurate sitemaps and search-engine reindexing (e.g., Google).

September 2024

Release date: September 26, 2024

Fix System-level and infrastructure improvements to enhance security, performance, and stability.

August 2024

Release date: August 22, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

Fix Product information can now be retrieved without product override (prices) data. Previously, these queries returned: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Release date: August 13, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Added support to retrieve all variants by product SKU. See the Catalog Service API Reference.

May 2024

Release date: May 23, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

Fix The InStock flag for option values now respects the scoped enabled status of the product variant.

Fix Added support for product prices with up to 16 digits and 4 decimal places. Resync from the Data Management dashboard or CLI to apply updates.

Known limitations

The following features are not yet supported:

  • The maximum size for dynamic attributes payload is 9 MB.
  • The Group product price can be calculated with simple product prices.
  • In an image array, only the first image contains roles.

Use API Mesh and the Core GraphQL API for:

  • Minimum Advertised Price
  • Tier pricing
  • Bundle products with fixed prices

For details and examples, see Catalog Service and API Mesh.

April 2024

Release date: April 11, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Added support for PHP 8.3.

New The products and refineProduct queries now return customizable options data for both simple and complex products.

February 2024

Release date: February 22, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New The Data Management Dashboard is now available for data streams (Product Recommendations, Live Search, Catalog Service). Requires catalog-service metapackage v3.1.0+.

Release date: February 13, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Product videos are now supported by the Catalog Service API.
Fix Out-of-stock options are now shown in the PDP widget.

Known limitations

These features are not yet supported:

  • The maximum size for dynamic attributes payload is 9 MB.
  • Group product price. This value can be calculated with simple product prices.
  • In an image array, only the first image contains roles.

Use API Mesh and the Core GraphQL API for:

October 2023

Release date: October 12, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Catalog Service supports the inStock flag for product variants.
New The urlKey and externalId fields have been added to the GraphQL schema.
New Downloadable products and gift cards are now supported.

September 2023

Release date: September 19, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Catalog Service now uses SaaS price indexing.
Fix This release contains bug fixes and improvements on the service side.

July 2023

Release date: July 18, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Catalog Service now supports the recommendations GraphQL query for Product Recommendations.

June 2023

Release date: June 27, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New The Catalog Service API now supports related products.

April 2023

Release date: April 12, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Catalog Service now cleans up deleted product variants.
Fix Infrastructure scalability and performance improvements.

March 2023

Release date: March 28, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Added swatches to the products query.
New Added the ability to get entityId using API Mesh.

Release date: March 6, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Added categories GraphQL functionality.
Fix Improved performance and API scalability.

February 2023

Release date: February 7, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New Published catalog-service metapackage to simplify installation steps.
Fix API scalability and performance improvements.

January 2023

Release date: January 17, 2023

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New Simplified and improved the onboarding experience.
New New customer sandbox endpoints are available for pre-production testing.
New Support added for virtual products.
Fix API scalability and performance improvements.

November 2022

Release date: November 18, 2022

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New Catalog Service now supports Adobe’s API Mesh.
Fix Improved API scalability and overall performance.

October 2022

Release date: October 4, 2022

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New Support for bundled and grouped products.
New Added B2B visibility overrides. Products are now searchable and can be added to the cart for specific customer groups.
Fix Service is now more stable and has improved performance.

September 2022

Release date: September 12, 2022

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New Variant images: product images returned based on selected options.
New Price roles: only members of specific customer groups can see product prices.
Fix Improved stability and performance of the service.
New Updates are received when products are deleted from the catalog.

August 2022

Release date: August 9, 2022

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.x and newer

New The products and refineProduct queries return the following data:

  • Predefined (system) product attributes.
  • Dynamic product attributes and filter them by role (product display page/product list page).
  • Product options.
  • Product images and filter them by role (PDP/PLP).
  • A specific price for simple products and price ranges for configurable products.
  • Customer group prices and price ranges. They return a fallback default price on shoppers without a customer group.
  • Product types that use B2B customer-specific pricing.

Catalog Service metapackage

Updates to the Catalog Service PHP metapackage (magento/catalog-service).

  • For Adobe Commerce as a Cloud Service customers, the latest version is installed in your environment.

  • For Adobe Commerce on cloud or on premises, Adobe recommends using Composer to upgrade the Catalog Service metapackage in your cloud environments the latest release.

v3.3.0 release

Release date: October 14, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Data Services upgrade—magento/data-services dependency updated to ^8.0.0. Verify environment and custom Data Services API usage for 8.x compatibility before upgrading.

New Updated version and metadata for the 3.3.0 release.

v3.2.0 release

Release date: April 12, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Version and metadata updated for 3.2.0. No other dependency changes.

v3.1.0 release

Release date: January 26, 2024

[Supported]{class="badge informative" title="Supported"} Adobe Commerce versions 2.4.4 and newer

New Added new package dependencies:

  • Category permission data exporter (magento/module-category-permission-data-exporter) for exporting category permission data used by the catalog service.
  • Catalog Sync Admin magento/module-catalog-sync-admin for Admin UI and configuration related to catalog sync.

New Updated version and metadata for the 3.1.0 release.

Catalog Service Installer

The installer is delivered with the Catalog Service extension and handles installation and environment checks so the Catalog Service matches your Commerce stack.

  • For Adobe Commerce as a Cloud Service customers, the latest installer version is installed in your environment.

  • For Adobe Commerce on cloud infrastructure or on premises, keep the installer aligned with the Catalog Service metapackage.

Whenever you use Composer to upgrade the magento/catalog-service, the installer package is automatically updated to the latest version. You can also use Composer to upgrade magento/catalog-service-installer separately when these release notes describe a change you need, for example, support for a new PHP version. That way your installation tooling stays compatible with the Catalog Service version you run.

v1.0.6 release

Release date: March 25, 2026

New PHP 8.5—Ensures compatibility when Catalog Service operates on PHP 8.5.

recommendation-more-help
commerce-help-catalog-service