Skip to Content
ReferenceStorefrontv1.0.0 API ReferenceQueriesproductGroupByHandle

productGroupByHandle

Get a single product group by handle

Authentication

Public Access: Accessible with the public API key

Query Structure

{
  productGroupByHandle(handle: String!) {
    # ProductGroup fields
  }
}

Arguments

ArgumentTypeRequiredDescription
handleStringYesThe handle of the product group to retrieve

Return Type

ProductGroup - Represents a product group in the store, including its metadata, SEO fields, relationships, and available filters for GraphQL queries.

Example

{
  productGroupByHandle(handle: "electronics") {
    id
    title
    handle
    description
    image
    productsCount
    seoTitle
    seoDescription
    seoKeywords
    url
    parent {
      id
      title
      handle
    }
    breadcrumbs {
      id
      title
      handle
    }
    productGroups {
      id
      title
      handle
    }
    products {
      edges {
        node {
          id
          title
        }
      }
    }
  }
}