From e56e8b6c4f17fff7c4f6ecb87730cc18aa2ad655 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:14:47 -0500 Subject: [PATCH 1/9] Enhance Catalog Service documentation Updated the documentation to include API reference and related topics. --- src/pages/graphql/schema/catalog-service/index.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/src/pages/graphql/schema/catalog-service/index.md b/src/pages/graphql/schema/catalog-service/index.md index 723f76c7f..0863a7b58 100644 --- a/src/pages/graphql/schema/catalog-service/index.md +++ b/src/pages/graphql/schema/catalog-service/index.md @@ -8,8 +8,13 @@ keywords: # Catalog Service for Adobe Commerce -The Catalog Service for Adobe Commerce extension contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). The queries in this schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. +The Catalog Service for Adobe Commerce extension contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). + +The queries in the Catalog Service schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. You can optionally implement [API Mesh for Adobe Developer App Builder](https://developer.adobe.com/graphql-mesh-gateway/) to integrate the core and Catalog Service GraphQL schemas with private and third-party APIs, as well as other software interfaces. The mesh can be configured to ensure that calls routed to each endpoint contain the correct authorization information in the headers. -The [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview) describes the architecture and implementation of this product. +## Related topics + +- [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview)–Learn about the Catalog Service architecture, implementation, and how to use the service. + From bb808a4822c468c33be9cc3d901cf1db1254ff5e Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:21:39 -0500 Subject: [PATCH 2/9] Fix formatting in Catalog Service documentation Fix linting errors. --- src/pages/graphql/schema/catalog-service/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/pages/graphql/schema/catalog-service/index.md b/src/pages/graphql/schema/catalog-service/index.md index 0863a7b58..e72344840 100644 --- a/src/pages/graphql/schema/catalog-service/index.md +++ b/src/pages/graphql/schema/catalog-service/index.md @@ -8,7 +8,7 @@ keywords: # Catalog Service for Adobe Commerce -The Catalog Service for Adobe Commerce extension contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). +The Catalog Service for Adobe Commerce extension contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). The queries in the Catalog Service schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. @@ -17,4 +17,3 @@ You can optionally implement [API Mesh for Adobe Developer App Builder](https:// ## Related topics - [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview)–Learn about the Catalog Service architecture, implementation, and how to use the service. - From 99f97b7b3eb69aa82fe707dbc211cd8f819f27d7 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:50:36 -0500 Subject: [PATCH 3/9] Apply suggestion from @meker12 --- src/pages/graphql/schema/catalog-service/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/graphql/schema/catalog-service/index.md b/src/pages/graphql/schema/catalog-service/index.md index e72344840..c466b2788 100644 --- a/src/pages/graphql/schema/catalog-service/index.md +++ b/src/pages/graphql/schema/catalog-service/index.md @@ -8,7 +8,7 @@ keywords: # Catalog Service for Adobe Commerce -The Catalog Service for Adobe Commerce extension contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). +The Catalog Service for Adobe Commerce contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). The queries in the Catalog Service schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. From 0aee38e14e283fc142877a881fce43c51ea69081 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:53:49 -0500 Subject: [PATCH 4/9] Update index.md --- src/pages/graphql/schema/live-search/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/graphql/schema/live-search/index.md b/src/pages/graphql/schema/live-search/index.md index 32fc8f092..81fa10179 100644 --- a/src/pages/graphql/schema/live-search/index.md +++ b/src/pages/graphql/schema/live-search/index.md @@ -7,7 +7,7 @@ keywords: - Search --- -# Live Search +# Live Search GraphQL Schema Reference Live Search is a set of standalone packages for Adobe Commerce that replaces the standard search capabilities. It provides GraphQL functionality that is currently separate from the built-in GraphQL functionality provided in Adobe Commerce and Magento Open Source. Live Search GraphQL requires connecting to a different endpoint and specifying a different set of HTTP headers. From 7cebdcc8ee8de4b04f580b42d95cdbe9989a9f3f Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:54:34 -0500 Subject: [PATCH 5/9] Revise title for Product Recommendations documentation Updated the title of the Product Recommendations section to include 'GraphQL Schema Reference'. --- src/pages/graphql/schema/product-recommendations/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/graphql/schema/product-recommendations/index.md b/src/pages/graphql/schema/product-recommendations/index.md index 760c9ebe4..010b098cf 100644 --- a/src/pages/graphql/schema/product-recommendations/index.md +++ b/src/pages/graphql/schema/product-recommendations/index.md @@ -6,7 +6,7 @@ keywords: - Services --- -# Product Recommendations +# Product Recommendations GraphQL Schema Reference Product Recommendations is a service that suggests products based on the browsing patterns of other shoppers. Product recommendations are surfaced on the storefront as units with labels, such as "Customers who viewed this product also viewed" or "Customers who bought this product also bought". You can create, manage, and deploy recommendations across your store views directly from the Adobe Commerce Admin. From a48494f9caf0645654432b31545ca642e82489ab Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 10:57:13 -0500 Subject: [PATCH 6/9] Clarify Live Search installation and usage instructions Updated the installation and implementation instructions for the Live Search service. --- src/pages/graphql/schema/live-search/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/graphql/schema/live-search/index.md b/src/pages/graphql/schema/live-search/index.md index 81fa10179..6e240c63d 100644 --- a/src/pages/graphql/schema/live-search/index.md +++ b/src/pages/graphql/schema/live-search/index.md @@ -17,7 +17,7 @@ You can connect to the Live Search GraphQL endpoint to test sample queries using - Through a standalone version of GraphQL Playground, or any other IDE, such as GraphiQL or Postman. In these applications you must specify the endpoint URL and provide a set of HTTP headers for each call. -For instructions on how to install and implement this product, see [Introduction to Live Search](https://experienceleague.adobe.com/en/docs/commerce/live-search/overview). +For instructions on how to install, implement, and use the Live Search service, see [Introduction to Live Search](https://experienceleague.adobe.com/en/docs/commerce/live-search/overview). ## Error Codes From 3c394db857bf501bfc59ac8a305a9841735e7fea Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 11:14:17 -0500 Subject: [PATCH 7/9] Revise Catalog Service GraphQL schema documentation Updated the documentation for the Catalog Service GraphQL schema, clarifying its purpose and usage in Adobe Commerce. --- src/pages/graphql/schema/catalog-service/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/pages/graphql/schema/catalog-service/index.md b/src/pages/graphql/schema/catalog-service/index.md index c466b2788..785bcaca1 100644 --- a/src/pages/graphql/schema/catalog-service/index.md +++ b/src/pages/graphql/schema/catalog-service/index.md @@ -6,14 +6,14 @@ keywords: - Services --- -# Catalog Service for Adobe Commerce +# Catalog Service GraphQL Schema for Adobe Commerce -The Catalog Service for Adobe Commerce contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the [core GraphQL schema](../index.md). This documentation describes the graphQL schema and provides API reference documentation. For information about the architecture, implementation, and use of the Catalog Services, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). - -The queries in the Catalog Service schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. +The Catalog Service extension for Adobe Commerce contributes to a services-only GraphQL schema that contains queries that return specialized catalog data that is not available in the built-in GraphQL functionality provided in Adobe Commerce and Magento Open Source. The queries in this schema allow Commerce merchants to quickly and fully render product-related content on the storefront, including product detail pages and product list pages. You can optionally implement [API Mesh for Adobe Developer App Builder](https://developer.adobe.com/graphql-mesh-gateway/) to integrate the core and Catalog Service GraphQL schemas with private and third-party APIs, as well as other software interfaces. The mesh can be configured to ensure that calls routed to each endpoint contain the correct authorization information in the headers. -## Related topics +For instructions on how to install, implement, and use the Catalog Service, see the [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview). -- [Catalog Service Guide](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/overview)–Learn about the Catalog Service architecture, implementation, and how to use the service. +>[!NOTE] +> +>If your Commerce instance uses Live Search or Product Recommendations, the Catalog Service is installed and updated automatically when you onboard or update those services. If you are using Adobe Commerce as a Cloud Service, the latest version of the Catalog Service metapackage is available in your environment. To begin using the service, see [Getting started with the Catalog Service](https://experienceleague.adobe.com/en/docs/commerce/catalog-service/get-started). From 89ac7d698061136388bbe900f7ae5ee1d3060e55 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 11:22:46 -0500 Subject: [PATCH 8/9] Update index.md --- src/pages/graphql/schema/live-search/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/pages/graphql/schema/live-search/index.md b/src/pages/graphql/schema/live-search/index.md index 6e240c63d..e2ddef1ff 100644 --- a/src/pages/graphql/schema/live-search/index.md +++ b/src/pages/graphql/schema/live-search/index.md @@ -1,6 +1,7 @@ --- title: Live Search -description: Learn how Live Search implements GraphQL. +description: Explore the Live Search GraphQL schema, learn how to query catalog data through its endpoint, test requests, and troubleshoot common error codes. + keywords: - GraphQL - Services From 46318a2ea33df637ed425156b0132c44bf38f7a3 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Thu, 27 Aug 2026 11:27:01 -0500 Subject: [PATCH 9/9] Revise Product Recommendations documentation Updated the description and content for clarity and detail. --- src/pages/graphql/schema/product-recommendations/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/pages/graphql/schema/product-recommendations/index.md b/src/pages/graphql/schema/product-recommendations/index.md index 010b098cf..75bed82be 100644 --- a/src/pages/graphql/schema/product-recommendations/index.md +++ b/src/pages/graphql/schema/product-recommendations/index.md @@ -1,6 +1,6 @@ --- title: Product Recommendations -description: Learn how Product Recommendations implements GraphQL. +description: Explore the Product Recommendations GraphQL schema. Learn how to query catalog data through its endpoint, test requests, and troubleshoot common error codes. keywords: - GraphQL - Services @@ -8,8 +8,8 @@ keywords: # Product Recommendations GraphQL Schema Reference -Product Recommendations is a service that suggests products based on the browsing patterns of other shoppers. Product recommendations are surfaced on the storefront as units with labels, such as "Customers who viewed this product also viewed" or "Customers who bought this product also bought". You can create, manage, and deploy recommendations across your store views directly from the Adobe Commerce Admin. +The Product Recommendations service suggests products based on the browsing patterns of other shoppers. Product recommendations are surfaced on the storefront as units with labels, such as "Customers who viewed this product also viewed" or "Customers who bought this product also bought". You can create, manage, and deploy recommendations across your store views directly from the Adobe Commerce Admin. For headless storefronts, use the Product Recommendations GraphQL query to retrieve recommendation blocks for a given SKU and render them in your storefront. The `recommendations` query returns recommended products based on the provided SKU. -Read more in the [Introduction to Product Recommendations](https://experienceleague.adobe.com/en/docs/commerce/product-recommendations/overview). +For instructions on how to install, implement, and use the Product Recommendations service, see [Introduction to Product Recommendations](https://experienceleague.adobe.com/en/docs/commerce/product-recommendations/overview).