Skip to Content
ReferenceStorefrontv1.0.0 API ReferenceQueriesproductByHandle

productByHandle

Get a single product by handle

Authentication

Public Access: Accessible with the public API key

Query Structure

{
  productByHandle(handle: String!) {
    # Product fields
  }
}

Arguments

ArgumentTypeRequiredDescription
handleStringYesThe handle of the product to retrieve

Return Type

Product - Describes a product with detailed information including variants, images, pricing, and related products.

Example

{
  productByHandle(handle: "awesome-product") {
    id
    title
    handle
    description
    shortDescription
    seoTitle
    seoDescription
    seoKeywords
    rating
    reviewCount
    maxRating
    isAvailable
    isDirectlyBuyable
    featuredImage {
      src
      alt
    }
    variants {
      id
      title
      price
      compareAtPrice
      isAvailable
    }
    optionsWithValues {
      handle
      name
      values
    }
    tags
    manufacturer {
      name
    }
    related {
      id
      title
      handle
    }
  }
}