Skip to content

Update GraphQL reference for categories API changes#335

Open
meker12 wants to merge 8 commits intomainfrom
remove-accs-queries-from-merch-svcs
Open

Update GraphQL reference for categories API changes#335
meker12 wants to merge 8 commits intomainfrom
remove-accs-queries-from-merch-svcs

Conversation

@meker12
Copy link
Copy Markdown
Contributor

@meker12 meker12 commented Apr 9, 2026

Purpose of this pull request

Align the Merchandising Services storefront categories guide and the Spectaql-generated Merchandising GraphQL reference with the category APIs:

  • Document searchCategory, optional family on categoryTree, updated depth behavior (with vs without starting slugs)

  • Filter out ACCS queries that are not applicable to Merchandising Services.

  • Fixe the CategoryNavigationView API reference link and a Commerce Admin typo in the warning callout.

  • Removed ACCS queries that are not part of the Catalog Service capabilities.

JIRA: COMOPT-1831

Affected pages

whatsnew
Updated Implement categories on the Storefront to cover the searchCategory query, optional family and depth behavior for categoryTree, and how CategoryTreeView applies to search results. Updated the Merchandising API Reference to match the schema.

- Updated `categoryTree` query description to include filtering by family.
- Added `searchCategory` query for searching categories by name with optional filtering and pagination.
- Updated documentation to reflect new query capabilities and improved descriptions for existing queries.
- Added new fields for `isSubscribedProductAlertPrice` and `isSubscribedProductAlertStock` in the metadata.
- Improved clarity in the `categories-storefront-implementation.md` regarding category queries and their usage.
@meker12 meker12 self-assigned this Apr 9, 2026
@github-project-automation github-project-automation bot moved this to 📋 Needs Review in Commerce - Pull Requests Apr 9, 2026
@meker12 meker12 added major-update Significant original updates to existing content technical Changes to code, examples, or technical processes labels Apr 9, 2026
@meker12 meker12 force-pushed the remove-accs-queries-from-merch-svcs branch from 6518a80 to b587659 Compare April 9, 2026 16:13
@meker12 meker12 marked this pull request as ready for review April 9, 2026 17:52
@meker12 meker12 changed the title Remove accs queries from merch svcs Update GraphQL reference for categories API changes Apr 9, 2026
@github-project-automation github-project-automation bot moved this from 📋 Needs Review to 👍 Approved in Commerce - Pull Requests Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

major-update Significant original updates to existing content technical Changes to code, examples, or technical processes

Projects

Status: 👍 Approved

Development

Successfully merging this pull request may close these issues.

3 participants