Single Product

About

The product query retrieves a single product by its unique identifier, SKU, or URL key. Use this query to:

• Fetch individual products for detail pages
• Look up products by different identifier types (ID, SKU, URL)
• Display complete product information including images, variants, and attributes
• Show product pricing, descriptions, and SEO metadata
• Retrieve inventory and availability status
• Build product-specific API integrations
• Generate product detail pages with all metadata

This query supports multiple lookup methods (ID, SKU, or URL key) and can return minimal data for previews or comprehensive data for full product detail pages, making it flexible for various use cases.

Arguments

Argument	Type	Description
id	ID	Product's unique system identifier. Use this for direct lookups.
sku	String	Stock Keeping Unit. Alternative identifier for product lookup.
urlKey	String	URL-friendly product slug. Alternative lookup method.
include_variants	Boolean	Include product variants (colors, sizes, options). Default: false
include_images	Boolean	Include product images. Default: false
include_attributes	Boolean	Include custom product attributes. Default: true
image_resolution	String	Image quality: thumbnail, medium, large, original. Default: large
include_recommendations	Boolean	Include related and recommended products. Default: false

Possible Returns

Field	Type	Description
id	ID!	Unique product identifier.
name	String!	Product display name.
sku	String!	Stock Keeping Unit for inventory tracking.
urlKey	String!	URL-friendly product slug for SEO.
type	String!	Product type (simple, configurable, grouped, bundle).
description	String	Full product description with formatting.
shortDescription	String	Brief product summary.
price	Float!	Base product price.
specialPrice	Float	Promotional/discounted price if applicable.
taxClass	String	Tax classification for the product.
images	[ProductImage!]	Array of product images with URLs and metadata.
images.url	String!	Image URL.
images.altText	String	Image alt text for accessibility.
images.position	Int	Image order in gallery.
images.width	Int	Image width in pixels.
images.height	Int	Image height in pixels.
attributes	[ProductAttribute!]	Custom product attributes and values.
variants	[ProductVariant!]	Product variants (colors, sizes, options).
variants.sku	String!	Variant SKU.
variants.price	Float!	Variant-specific price.
inventory	InventoryInfo!	Stock availability information.
inventory.stock	Int!	Current stock quantity.
inventory.status	String!	Stock status (in_stock, out_of_stock, low_stock).
categories	[Category!]!	Categories this product belongs to.
tags	[String!]	Product tags and labels.
seo	ProductSEO!	SEO metadata.
status	String!	Product status (active, draft, inactive).
visibility	String!	Visibility status (visible, not visible, search only).
createdAt	DateTime!	Product creation date.
updatedAt	DateTime!	Last modification date.