DocumentationCommerceCatalog Service Guide

Commerce Storefront Catalog Service Release Notes

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin

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

  • Storefront Catalog Service releases

    • Catalog Service API schema enhancements for improved data retrieval.
    • Security, performance, and reliability improvements for the Catalog Service API and underlying infrastructure.

  • Catalog Service metapackage releases

    • Updated dependencies for improved performance, stability, and compatibility with other Adobe Commerce components.

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

v1.48 release

February 19, 2025

New The categoryTree query in the GraphQL API now returns category descriptions, images, and SEO meta tags. This update delivers the data that storefront developers need to display category imagery and improve search engine optimization with proper meta titles, descriptions, and keywords. Only supported on Commerce implementations using the composable catalog data model for headless storefronts<

v1.47 release

February 12, 2025

New The API service now supports the CategoryProductView type, enabling enhanced views and queries for products by category. This update allows developers to efficiently retrieve and filter product data based on category, improving flexibility and performance for category-driven use cases. For details, see Implement categories on the storefront. Only supported on Commerce implementations using the composable catalog data model for headless storefronts

v1.46 release

December 11, 2025

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

v1.45 release

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.

v1.44 release

November 6, 2025

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

v1.43 release

November 3, 2025

New Product Layers for multi-dimensional product customization—Added support for channel-specific, locale-aware content delivery for Adobe Commerce Optimizer implementations.

  • Serve different product content to different customer segments

  • Apply locale-specific customizations without duplicating base data

  • Control field-level overrides with Layer Masks

  • Support for premium, seasonal, and mobile-optimized content layers

    Layers are retrieved using the existing products query, are applied server-side from request headers, and require no schema changes. See Catalog layer in the Adobe Commerce Optimizer Guide.

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.

v1.42 release

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.

v1.41 release

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.

v1.40 release

July 30, 2025

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

v1.39 release

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.

v1.38 release

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.

v1.37 release

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.

v1.36 release

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.

Previous versions

v1.35 release

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.

v1.34 release

March 23, 2025

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

v1.33 release

April 29, 2025

Fix System-level and infrastructure improvements. Infrastructure now supports extremely large catalogs (up to ~440 million SKUs) without impacting existing workloads.

v1.32 release

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.

v1.31 release

February 18, 2025

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

v1.30 release

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.

v1.29 release

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.

v1.28 release

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

v1.27 release

September 26, 2024

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

v1.26 release

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).

v1.23 release

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.

v1.22 release

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.

v1.19 release

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.

v1.18 release

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.

v1.17 release

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+.

v1.16 release

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:

v1.13 release

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.

v1.12 release

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.

v1.11 release

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.

v1.10 release

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.

v1.7 release

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.

v1.6 release

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.

v1.5 release

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.

v1.4 release

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.

v1.3 release

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.

v1.1 release

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.

v1.0 release

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.

0.3 release - Beta+

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.

Beta Release

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 on-premises, Adobe recommends using Composer to upgrade the Catalog Service metapackage in your cloud environments the latest release.

v3.3.0 release

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.
ea
New Updated version and metadata for the 3.3.0 release.

v3.2.0 release

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

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.

recommendation-more-help
caa758b0-fff2-4350-a281-16253ff7b81f