Choose a version:

product

query

Fetch a specific Product by one of its unique attributes.

Arguments

Anchor to handlehandle •String: The handle of the Product.
Anchor to idid •ID: The ID of the Product.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to ProductProduct •Product: The Product object lets you manage products in a merchant’s store.

Products are the goods and services that merchants offer to customers. They can include various details such as title, description, price, images, and options such as size or color. You can use product variants to create or update different versions of the same product. You can also add or update product media. Products can be organized by grouping them into a collection.

Learn more about working with products and collections.

Was this section helpful?

Load products which are published in a given context
Load translated and localized content for a product
Retrieve local prices for a product

Examples

Open in GraphiQL

const { storefront } = await unauthenticated.storefront(

'your-development-store.myshopify.com'

);

const response = await storefront.graphql(

`#graphql

query Products @inContext(country: GB) {

woolSweater: product(handle: "wool-sweater") {

title

}

alarmClock: product(handle: "alarm-clock") {

title

}

products(first: 2) {

nodes {

title

}

}`,

);

const data = await response.json();

query Products @inContext(country: GB) {
  woolSweater: product(handle: "wool-sweater") {
    title
  }
  alarmClock: product(handle: "alarm-clock") {
    title
  }
  products(first: 2) {
    nodes {
      title
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/api/2024-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "query Products @inContext(country: GB) { woolSweater: product(handle: \"wool-sweater\") { title } alarmClock: product(handle: \"alarm-clock\") { title } products(first: 2) { nodes { title } } }"
}'

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  query Products @inContext(country: GB) {
    woolSweater: product(handle: "wool-sweater") {
      title
    }
    alarmClock: product(handle: "alarm-clock") {
      title
    }
    products(first: 2) {
      nodes {
        title
      }
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: `query Products @inContext(country: GB) {
    woolSweater: product(handle: "wool-sweater") {
      title
    }
    alarmClock: product(handle: "alarm-clock") {
      title
    }
    products(first: 2) {
      nodes {
        title
      }
    }
  }`,
});

Response

JSON

{

"woolSweater": {

"title": "Wool sweater"

"alarmClock": null,

"products": {

"nodes": [

{

"title": "Wool sweater"

}

]

}