Skip to content

Catalog GraphQL

Served by CatalogModule on commercetools, CatalogModule on medusa and CatalogModule on sfcc.

Each operation has its own page with its arguments, an example and the engines that serve it. The types link to their fields on the catalog types page.

Operations

OperationDescriptionServed by
categoriesQueryGet a paginated list of product categories with optional search and sortingcommercetoolsmedusasfcc
productQueryGet a single product by its slugcommercetoolsmedusasfcc
productCategoryPageByPathQueryGet category page data with associated products and CMS content by pathcommercetoolsmedusasfcc
productsQueryGet a paginated list of all products without search or filteringcommercetoolsmedusasfcc
productsBySkuQueryRetrieve specific products by their SKU valuescommercetoolsmedusasfcc
productSearchQuerySearch for products with advanced filtering, sorting, and pagination capabilitiescommercetoolsmedusasfcc
productSearchMaxResultsQueryThe most products productSearch can reach by paging in this deployment, so a storefront stops offering pages past it; a page beyond it fails or comes back empty.commercetoolsmedusasfcc
productSearchSuggestionsQuerySuggestions for a partly typed search term, for the panel under a search field: completions of the term, the categories holding the most matching products, and the best matching products.commercetoolsmedusasfcc
productSortOrdersQueryThe sort orders productSearch applies in this deployment, so a storefront offers only those.commercetoolsmedusasfcc

Types

TypeDescription
AbstractProductSpecificationAttributeInterface
BrandObjectA brand, as content refers to it by key.
CatalogPageObject
CategoryFacetObjectCategory-based facet for hierarchical filtering (e.g., categories, collections)
CategorySortOrderTypeEnumAvailable sorting options for category listings
DimensionObjectDimension option specific for this variant (see ProductVariantDimension for available options)
FacetUnionUnion of different facet types for product filtering
FacetFilterInputInput object
FacetValueObjectIndividual value option within a facet with count information
FilterConditionObjectA condition a listing applies before the shopper's facet selections, which cannot widen it.
FilterConditionInputInput objectA condition a listing applies before the shopper's facet selections, which cannot widen it.
LocalizedSlugObjectLocalized URL slug for different language versions
MediaUnionUnion of different media types available for products
OptionsFacetObjectMulti-option facet for categorical filtering (e.g., color, brand)
ProductObjectProduct entity containing all product information, variants, and metadata.
ProductAccessoryObjectA variant sold for use with another one.
ProductAccessoryKindTypeEnumHow an accessory relates to the variant it is listed for.
ProductAvailabilityTypeEnumProduct availability status indicating stock levels and purchase options
ProductBundleObjectProducts sold together with a main product, at the bundle's discount.
ProductBundleItemObjectA product offered as an extra in a bundle.
ProductCategoriesResultObjectPaginated result containing product category pages
ProductCategoryObject
ProductCategoryPageObjectProduct category page containing products and metadata
ProductCategorySuggestionObjectA category suggested for a search term, with how much of the result it holds.
ProductDocumentObjectA file that belongs to a product variant, such as its datasheet.
ProductDocumentKindTypeEnumWhat a product document is, so a page can group and label it.
ProductEntityReferenceObjectReference to a product entity with basic information
ProductImage360Object360-degree product image set for interactive viewing
ProductKindTypeEnumHow a product reaches the buyer.
ProductListObject
ProductListingConfigObject
ProductPriceTierObjectThe unit price from an order quantity on.
ProductRibbonObject
ProductSearchSuggestionsObjectWhat a search field suggests for a partly typed term.
ProductSpecificationAttributeUnion
ProductSpecificationBooleanAttributeObject
ProductSpecificationDateTimeAttributeObject
ProductSpecificationEnumAttributeObject
ProductSpecificationEnumListAttributeObject
ProductSpecificationEnumValueObject
ProductSpecificationGroupObject
ProductSpecificationNumberAttributeObject
ProductSpecificationStringAttributeObject
ProductsResultObjectPaginated result containing products and available facets for filtering
ProductVariantObjectSpecific variant of a product with unique SKU, pricing, and attributes
ProductVariantDimensionObjectProduct variant dimension containing selectable options (e.g., size, color)
ProductVariantDimensionColorOptionObjectColor-based product variant dimension option with hex color value
ProductVariantDimensionImageOptionObjectImage-based product variant dimension option (e.g., pattern, style)
ProductVariantDimensionOptionInterfaceInterface for product variant dimension options with common properties
ProductVariantDimensionTextOptionObjectText-based product variant dimension option (e.g., size, material)
ProductVariantQuantityRuleObjectHow many of a variant can be ordered on one line.
ProductVariantStockObjectA variant's stock, as a buyer is told it.
ProductYouTubeVideoObjectYouTube video embedded as product media
RangeFacetObjectRange-based facet for numeric filtering (e.g., price, rating)
ReviewsObject
StockLevelTypeEnumHow a variant's stock reads to a buyer.
ToggleFacetObjectBoolean toggle facet for binary filtering (e.g., in stock, on sale)
WarehouseObjectA place stock is kept and shipped from.
WarehouseStockObjectHow much of a variant one warehouse holds.