name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields
in a document.			- `query=Bob Norman` - `query=title:green hoodie`
barcode	string	Filter by the product variant `barcode`
field.			- `barcode:ABC-abc-1234`
bundles	boolean	Filter by a [product
bundle](https://shopify.dev/docs/apps/build/product-merchandising/bundles).
A product bundle is a set of two or more related products, which are
commonly offered at a discount.			- `bundles:true`
category_id	string	Filter by the product category ID
(`product.category.id`). A product category is the category of a product
from Shopify's Standard Product Taxonomy.
		- `category_id:sg-4-17-2-17`
collection_id	id	Filter by the collection `id`
field.			- `collection_id:108179161409`
combined_listing_role	string	Filter by the role of the product in a combined listing.
- `parent` - `child` - `no_role`		-
`combined_listing_role:parent`
created_at	time	Filter by the date and time when the product was
created.			- `created_at:>'2020-10-21T23:39:20Z'` -
`created_at:<now` - `created_at:<='2024'`
delivery_profile_id	id	Filter by the delivery profile `id`
field.			- `delivery_profile_id:108179161409`
error_feedback	string	Filter by products with publishing errors.
gift_card	boolean	Filter by the product `isGiftCard`
field.			- `gift_card:true`
handle	string	Filter by a comma-separated list of product handles.
		- `handle:the-minimal-snowboard`
has_only_composites	boolean	Filter by products that have only
composite variants.			- `has_only_composites:true`
has_only_default_variant	boolean	Filter by products that have only a
default variant. A default variant is the only variant if no other variants
are specified.			- `has_only_default_variant:true`
has_variant_with_components	boolean	Filter by products that have
variants with associated components.			-
`has_variant_with_components:true`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
inventory_total	integer	Filter by inventory count.		-
`inventory_total:0` - `inventory_total:>150` -
`inventory_total:>=200`
is_price_reduced	boolean	Filter by products that have a reduced price.
For more information, refer to the `CollectionRule`
object.			- `is_price_reduced:true`
metafields.{namespace}.{key}	mixed	Filters resources by metafield
value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about
querying by metafield value.
		- `metafields.custom.on_sale:true` -
`metafields.product.material:"gid://shopify/Metaobject/43458085"`
out_of_stock_somewhere	boolean	Filter by products that are out of
stock in at least one location.			- `out_of_stock_somewhere:true`
price	bigdecimal	Filter by the product variant `price`
field.			- `price:100.57`
product_configuration_owner	string	Filter by the app
`id`
field.			- `product_configuration_owner:10001`
product_publication_status	string	Filter by channel approval process
status of the resource on a channel, such as the online store. The value is
a composite of the channel `app` ID
(`Channel.app.id`) and one of the valid values. For simple visibility checks, use published_status
instead.	- `* {channel_app_id}-approved` - `*
{channel_app_id}-rejected`<br/> -` * {channel_app_id}-needs_action` -
`* {channel_app_id}-awaiting_review` - `*
{channel_app_id}-published`<br/> -` * {channel_app_id}-demoted`<br/> -` *
{channel_app_id}-scheduled`<br/> -` *
{channel_app_id}-provisionally_published`		-
`product_publication_status:189769876-approved`
product_type	string	Filter by a comma-separated list of [product
types](https://help.shopify.com/manual/products/details/product-type).

product_type:snowboard | | publication_ids | string | Filter by a comma-separated list of publication IDs that are associated with the product. | | | - publication_ids:184111530305,184111694145 | | publishable_status | string | Deprecated: This parameter is deprecated as of 2025-12 and will be removed in a future API version. Use published_status for visibility checks. Filter by the publishable status of the resource on a channel. The value is a composite of the channel app ID (Channel.app.id) and one of the valid status values. | - * {channel_app_id}-unset
- * {channel_app_id}-pending
- * {channel_app_id}-approved
- * {channel_app_id}-not_approved | | - publishable_status:580111-unset
- publishable_status:580111-pending | | published_at | time | Filter by the date and time when the product was published to the online store and other sales channels. | | | - published_at:>2020-10-21T23:39:20Z
- published_at:<now
- published_at:<=2024 | | published_status | string | Filter resources by their visibility and publication state on a channel. Online store channel filtering: - online_store_channel: Returns all resources in the online store channel, regardless of publication status. - published/visible: Returns resources that are published to the online store. - unpublished: Returns resources that are not published to the online store. Channel-specific filtering using a channel ID, channel handle, channel app ID (Channel.app.id), or app handle with suffixes: - {id_or_handle}-published: Returns resources published to the specified channel. - {id_or_handle}-visible: Same as {id_or_handle}-published (kept for backwards compatibility). - {id_or_handle}-intended: Returns resources added to the channel but not yet published. - {id_or_handle}-hidden: Returns resources not added to the channel or not published. Other: - unavailable: Returns resources not published to any channel. | - online_store_channel
- published
- visible
unpublished
- * {channel_id_or_handle}-published
- * {channel_id_or_handle}-visible
- * {channel_id_or_handle}-intended
- * {channel_id_or_handle}-hidden
- * {channel_app_id_or_handle}-published
- * {channel_app_id_or_handle}-visible
- * {channel_app_id_or_handle}-intended
- * {channel_app_id_or_handle}-hidden
- unavailable | | - published_status:online_store_channel
- published_status:published
- published_status:580111-published
published_status:580111-hidden
- published_status:my-channel-handle-published
- published_status:unavailable | | sku | string | Filter by the product variant sku field. Learn more about SKUs. | | | - sku:XYZ-12345 | | status | string | Filter by a comma-separated list of statuses. You can use statuses to manage inventory. Shopify only displays products with an ACTIVE status in online stores, sales channels, and apps. | - active
- archived
- draft | active | - status:active,draft | | tag | string | Filter objects by the tag field. | | | - tag:my_tag | | tag_not | string | Filter by objects that don’t have the specified tag. | | | - tag_not:my_tag | | title | string | Filter by the product title field. | | | - title:The Minimal Snowboard | | tracks_inventory | boolean | Filter by products that have inventory tracking enabled. | | | - tracks_inventory:true | | updated_at | time | Filter by the date and time when the product was last updated. | | | - updated_at:>'2020-10-21T23:39:20Z'
- updated_at:<now
- updated_at:<='2024' | | variant_id | id | Filter by the product variant id field. | | | - variant_id:45779434701121 | | variant_title | string | Filter by the product variant title field. | | | - variant_title:'Special ski wax' | | vendor | string | Filter by the origin or source of the product. Learn more about vendors and managing vendor information. | | | - vendor:Snowdevil
- vendor:Snowdevil OR vendor:Icedevil | You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

Anchor to savedSearchIdsavedSearchId

•ID

The ID of a saved search. The search’s query string is used as the query argument.

Anchor to sortKeysortKey

•ProductSortKeys

Default:ID

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to edgesedges •[ProductEdge!]! non-null: The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.
Anchor to nodesnodes •[Product!]! non-null: A list of nodes that are contained in ProductEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.
Anchor to pageInfopageInfo •PageInfo! non-null: An object that’s used to retrieve cursor information about the current page.

Was this section helpful?

Examples

Retrieve a list of products

Description

Retrieve a list of the first ten products. This example returns the ID and title for each product.

Query

query GetProducts {
  products(first: 10) {
    nodes {
      id
      title
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query GetProducts { products(first: 10) { nodes { id title } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query GetProducts {
  products(first: 10) {
    nodes {
      id
      title
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query GetProducts {
        products(first: 10) {
          nodes {
            id
            title
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "nodes": [
      {
        "id": "gid://shopify/Product/20995642",
        "title": "Element"
      },
      {
        "id": "gid://shopify/Product/108828309",
        "title": "Draft"
      },
      {
        "id": "gid://shopify/Product/121709582",
        "title": "Boots"
      },
      {
        "id": "gid://shopify/Product/440089423",
        "title": "IPod Nano - 8GB"
      },
      {
        "id": "gid://shopify/Product/558169081",
        "title": "Unpublished Boots"
      },
      {
        "id": "gid://shopify/Product/910489600",
        "title": "Crafty Shoes"
      },
      {
        "id": "gid://shopify/Product/912855135",
        "title": "SEO Boots"
      }
    ]
  }
}

Retrieve multiple sets of products with a single query

Description

Retrieve the five oldest and newest products by using [aliases](https://shopify.dev/docs/apps/build/graphql/basics/advanced#make-multiple-queries-in-one-request) to name the results. This example returns the ID and title for each product.

Query

query {
  newestProducts: products(first: 5, reverse: true) {
    edges {
      node {
        id
        title
      }
    }
  }
  oldestProducts: products(first: 5) {
    edges {
      node {
        id
        title
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { newestProducts: products(first: 5, reverse: true) { edges { node { id title } } } oldestProducts: products(first: 5) { edges { node { id title } } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    newestProducts: products(first: 5, reverse: true) {
      edges {
        node {
          id
          title
        }
      }
    }
    oldestProducts: products(first: 5) {
      edges {
        node {
          id
          title
        }
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    newestProducts: products(first: 5, reverse: true) {
      edges {
        node {
          id
          title
        }
      }
    }
    oldestProducts: products(first: 5) {
      edges {
        node {
          id
          title
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    newestProducts: products(first: 5, reverse: true) {
      edges {
        node {
          id
          title
        }
      }
    }
    oldestProducts: products(first: 5) {
      edges {
        node {
          id
          title
        }
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  newestProducts: products(first: 5, reverse: true) {
    edges {
      node {
        id
        title
      }
    }
  }
  oldestProducts: products(first: 5) {
    edges {
      node {
        id
        title
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        newestProducts: products(first: 5, reverse: true) {
          edges {
            node {
              id
              title
            }
          }
        }
        oldestProducts: products(first: 5) {
          edges {
            node {
              id
              title
            }
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "newestProducts": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/Product/912855135",
          "title": "SEO Boots"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/910489600",
          "title": "Crafty Shoes"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/558169081",
          "title": "Unpublished Boots"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/440089423",
          "title": "IPod Nano - 8GB"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/121709582",
          "title": "Boots"
        }
      }
    ]
  },
  "oldestProducts": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/Product/20995642",
          "title": "Element"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/108828309",
          "title": "Draft"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/121709582",
          "title": "Boots"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/440089423",
          "title": "IPod Nano - 8GB"
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/558169081",
          "title": "Unpublished Boots"
        }
      }
    ]
  }
}

Retrieve product IDs from published products

Description

Retrieve the IDs of the first two products that are published to your app. This example returns the product ID and whether the product is published to your app. You must have the `read_product_listings` access scope to return publication information.

Query

query ProductList {
  products(first: 2) {
    nodes {
      publishedOnCurrentPublication
      id
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query ProductList { products(first: 2) { nodes { publishedOnCurrentPublication id } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query ProductList {
    products(first: 2) {
      nodes {
        publishedOnCurrentPublication
        id
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query ProductList {
    products(first: 2) {
      nodes {
        publishedOnCurrentPublication
        id
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query ProductList {
    products(first: 2) {
      nodes {
        publishedOnCurrentPublication
        id
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query ProductList {
  products(first: 2) {
    nodes {
      publishedOnCurrentPublication
      id
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query ProductList {
        products(first: 2) {
          nodes {
            publishedOnCurrentPublication
            id
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "nodes": [
      {
        "publishedOnCurrentPublication": true,
        "id": "gid://shopify/Product/20995642"
      },
      {
        "publishedOnCurrentPublication": true,
        "id": "gid://shopify/Product/108828309"
      }
    ]
  }
}

Retrieve products by their ID using aliases

Description

This example demonstrates using [aliases](https://shopify.dev/docs/apps/build/graphql/basics/advanced#make-multiple-queries-in-one-request) to retrieve multiple products in a single query.

Query

query {
  glasses: product(id: "gid://shopify/Product/108828309") {
    title
    description
  }
  shoes: product(id: "gid://shopify/Product/910489600") {
    title
    description
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { glasses: product(id: \"gid://shopify/Product/108828309\") { title description } shoes: product(id: \"gid://shopify/Product/910489600\") { title description } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    glasses: product(id: "gid://shopify/Product/108828309") {
      title
      description
    }
    shoes: product(id: "gid://shopify/Product/910489600") {
      title
      description
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    glasses: product(id: "gid://shopify/Product/108828309") {
      title
      description
    }
    shoes: product(id: "gid://shopify/Product/910489600") {
      title
      description
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    glasses: product(id: "gid://shopify/Product/108828309") {
      title
      description
    }
    shoes: product(id: "gid://shopify/Product/910489600") {
      title
      description
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  glasses: product(id: "gid://shopify/Product/108828309") {
    title
    description
  }
  shoes: product(id: "gid://shopify/Product/910489600") {
    title
    description
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        glasses: product(id: "gid://shopify/Product/108828309") {
          title
          description
        }
        shoes: product(id: "gid://shopify/Product/910489600") {
          title
          description
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "glasses": {
    "title": "Cool Glasses",
    "description": "Cool Glasses"
  },
  "shoes": {
    "title": "Crafty Shoes",
    "description": "Crafty Shoes"
  }
}

Retrieve the first ten products after a given cursor

Description

Retrieve the first ten products after a given cursor and whether there's a subsequent page of results. This example returns the cursor for the next page of results. Learn more about [pagination](https://shopify.dev/docs/api/usage/pagination-graphql).

Query

query {
  products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
    edges {
      node {
        id
        title
        handle
      }
      cursor
    }
    pageInfo {
      hasNextPage
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { products(first: 10, after: \"eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=\") { edges { node { id title handle } cursor } pageInfo { hasNextPage } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
      edges {
        node {
          id
          title
          handle
        }
        cursor
      }
      pageInfo {
        hasNextPage
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
      edges {
        node {
          id
          title
          handle
        }
        cursor
      }
      pageInfo {
        hasNextPage
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
      edges {
        node {
          id
          title
          handle
        }
        cursor
      }
      pageInfo {
        hasNextPage
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
    edges {
      node {
        id
        title
        handle
      }
      cursor
    }
    pageInfo {
      hasNextPage
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        products(first: 10, after: "eyJsYXN0X2lkIjoyMDk5NTY0MiwibGFzdF92YWx1ZSI6IjIwOTk1NjQyIn0=") {
          edges {
            node {
              id
              title
              handle
            }
            cursor
          }
          pageInfo {
            hasNextPage
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/Product/108828309",
          "title": "Draft",
          "handle": "draft"
        },
        "cursor": "eyJsYXN0X2lkIjoxMDg4MjgzMDksImxhc3RfdmFsdWUiOiIxMDg4MjgzMDkifQ=="
      },
      {
        "node": {
          "id": "gid://shopify/Product/121709582",
          "title": "Boots",
          "handle": "boots"
        },
        "cursor": "eyJsYXN0X2lkIjoxMjE3MDk1ODIsImxhc3RfdmFsdWUiOiIxMjE3MDk1ODIifQ=="
      },
      {
        "node": {
          "id": "gid://shopify/Product/440089423",
          "title": "IPod Nano - 8GB",
          "handle": "ipod-nano"
        },
        "cursor": "eyJsYXN0X2lkIjo0NDAwODk0MjMsImxhc3RfdmFsdWUiOiI0NDAwODk0MjMifQ=="
      },
      {
        "node": {
          "id": "gid://shopify/Product/558169081",
          "title": "Unpublished Boots",
          "handle": "unpublished_boots"
        },
        "cursor": "eyJsYXN0X2lkIjo1NTgxNjkwODEsImxhc3RfdmFsdWUiOiI1NTgxNjkwODEifQ=="
      },
      {
        "node": {
          "id": "gid://shopify/Product/910489600",
          "title": "Crafty Shoes",
          "handle": "crappy-shoes"
        },
        "cursor": "eyJsYXN0X2lkIjo5MTA0ODk2MDAsImxhc3RfdmFsdWUiOiI5MTA0ODk2MDAifQ=="
      },
      {
        "node": {
          "id": "gid://shopify/Product/912855135",
          "title": "SEO Boots",
          "handle": "seo_boots"
        },
        "cursor": "eyJsYXN0X2lkIjo5MTI4NTUxMzUsImxhc3RfdmFsdWUiOiI5MTI4NTUxMzUifQ=="
      }
    ],
    "pageInfo": {
      "hasNextPage": false
    }
  }
}

Retrieve the first ten products associated with a product type

Description

Retrieve the first ten products associated with the snowboards product type. A [product type](https://help.shopify.com/manual/products/details/product-type) is a category that you can use to group products. Learn more about using [Shopify API search syntax](https://shopify.dev/docs/api/usage/search-syntax) to filter products.

Query

query {
  products(first: 10, query: "product_type:snowboards") {
    edges {
      node {
        title
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { products(first: 10, query: \"product_type:snowboards\") { edges { node { title } } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    products(first: 10, query: "product_type:snowboards") {
      edges {
        node {
          title
        }
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    products(first: 10, query: "product_type:snowboards") {
      edges {
        node {
          title
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    products(first: 10, query: "product_type:snowboards") {
      edges {
        node {
          title
        }
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  products(first: 10, query: "product_type:snowboards") {
    edges {
      node {
        title
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        products(first: 10, query: "product_type:snowboards") {
          edges {
            node {
              title
            }
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "edges": [
      {
        "node": {
          "title": "Element"
        }
      },
      {
        "node": {
          "title": "Draft"
        }
      }
    ]
  }
}

Retrieve the first ten products updated after a specified date

Description

Retrieve the first ten products updated after 2019-12-01. This example returns the ID and updated date for each product. Learn more about using [Shopify API search syntax](https://shopify.dev/docs/api/usage/search-syntax) to filter products.

Query

query {
  products(first: 10, query: "updated_at:>2019-12-01") {
    edges {
      node {
        id
        updatedAt
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { products(first: 10, query: \"updated_at:>2019-12-01\") { edges { node { id updatedAt } } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    products(first: 10, query: "updated_at:>2019-12-01") {
      edges {
        node {
          id
          updatedAt
        }
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    products(first: 10, query: "updated_at:>2019-12-01") {
      edges {
        node {
          id
          updatedAt
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    products(first: 10, query: "updated_at:>2019-12-01") {
      edges {
        node {
          id
          updatedAt
        }
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  products(first: 10, query: "updated_at:>2019-12-01") {
    edges {
      node {
        id
        updatedAt
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        products(first: 10, query: "updated_at:>2019-12-01") {
          edges {
            node {
              id
              updatedAt
            }
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/Product/440089423",
          "updatedAt": "2021-12-01T12:14:52Z"
        }
      }
    ]
  }
}

Retrieve the ten most recently created products

Description

Retrieve the ten most recently created products and the [publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) information for each product. You must have the `read_product_listings` access scope to return publication information.

Query

query {
  products(first: 10, reverse: true) {
    edges {
      node {
        id
        title
        handle
        resourcePublicationOnCurrentPublication {
          publication {
            id
          }
          publishDate
          isPublished
        }
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { products(first: 10, reverse: true) { edges { node { id title handle resourcePublicationOnCurrentPublication { publication { id } publishDate isPublished } } } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    products(first: 10, reverse: true) {
      edges {
        node {
          id
          title
          handle
          resourcePublicationOnCurrentPublication {
            publication {
              id
            }
            publishDate
            isPublished
          }
        }
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    products(first: 10, reverse: true) {
      edges {
        node {
          id
          title
          handle
          resourcePublicationOnCurrentPublication {
            publication {
              id
            }
            publishDate
            isPublished
          }
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    products(first: 10, reverse: true) {
      edges {
        node {
          id
          title
          handle
          resourcePublicationOnCurrentPublication {
            publication {
              id
            }
            publishDate
            isPublished
          }
        }
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  products(first: 10, reverse: true) {
    edges {
      node {
        id
        title
        handle
        resourcePublicationOnCurrentPublication {
          publication {
            id
          }
          publishDate
          isPublished
        }
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        products(first: 10, reverse: true) {
          edges {
            node {
              id
              title
              handle
              resourcePublicationOnCurrentPublication {
                publication {
                  id
                }
                publishDate
                isPublished
              }
            }
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "products": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/Product/912855135",
          "title": "SEO Boots",
          "handle": "seo_boots",
          "resourcePublicationOnCurrentPublication": null
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/910489600",
          "title": "Crafty Shoes",
          "handle": "crappy-shoes",
          "resourcePublicationOnCurrentPublication": null
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/558169081",
          "title": "Unpublished Boots",
          "handle": "unpublished_boots",
          "resourcePublicationOnCurrentPublication": null
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/440089423",
          "title": "IPod Nano - 8GB",
          "handle": "ipod-nano",
          "resourcePublicationOnCurrentPublication": null
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/121709582",
          "title": "Boots",
          "handle": "boots",
          "resourcePublicationOnCurrentPublication": null
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/108828309",
          "title": "Draft",
          "handle": "draft",
          "resourcePublicationOnCurrentPublication": {
            "publication": {
              "id": "gid://shopify/Publication/762454635"
            },
            "publishDate": "2005-01-02T00:00:00Z",
            "isPublished": true
          }
        }
      },
      {
        "node": {
          "id": "gid://shopify/Product/20995642",
          "title": "Element",
          "handle": "element",
          "resourcePublicationOnCurrentPublication": null
        }
      }
    ]
  }
}

Retrieve the total inventory and price range of products

Description

Retrieve the total inventory and price range of three products using a fragment. The example returns the minimum and maximum variant prices and total inventory count for each product. Learn more about [fragments](https://shopify.dev/docs/apps/build/graphql/basics/advanced#inline-fragments).

Query

query {
  Glasses: product(id: "gid://shopify/Product/20995642") {
    ...productInformation
  }
  Shoes: product(id: "gid://shopify/Product/910489600") {
    ...productInformation
  }
  Bracelet: product(id: "gid://shopify/Product/108828309") {
    ...productInformation
  }
}

fragment productInformation on Product {
  totalInventory
  priceRangeV2 {
    minVariantPrice {
      amount
    }
    maxVariantPrice {
      amount
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { Glasses: product(id: \"gid://shopify/Product/20995642\") { ...productInformation } Shoes: product(id: \"gid://shopify/Product/910489600\") { ...productInformation } Bracelet: product(id: \"gid://shopify/Product/108828309\") { ...productInformation } } fragment productInformation on Product { totalInventory priceRangeV2 { minVariantPrice { amount } maxVariantPrice { amount } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    Glasses: product(id: "gid://shopify/Product/20995642") {
      ...productInformation
    }
    Shoes: product(id: "gid://shopify/Product/910489600") {
      ...productInformation
    }
    Bracelet: product(id: "gid://shopify/Product/108828309") {
      ...productInformation
    }
  }
  
  fragment productInformation on Product {
    totalInventory
    priceRangeV2 {
      minVariantPrice {
        amount
      }
      maxVariantPrice {
        amount
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    Glasses: product(id: "gid://shopify/Product/20995642") {
      ...productInformation
    }
    Shoes: product(id: "gid://shopify/Product/910489600") {
      ...productInformation
    }
    Bracelet: product(id: "gid://shopify/Product/108828309") {
      ...productInformation
    }
  }
  
  fragment productInformation on Product {
    totalInventory
    priceRangeV2 {
      minVariantPrice {
        amount
      }
      maxVariantPrice {
        amount
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    Glasses: product(id: "gid://shopify/Product/20995642") {
      ...productInformation
    }
    Shoes: product(id: "gid://shopify/Product/910489600") {
      ...productInformation
    }
    Bracelet: product(id: "gid://shopify/Product/108828309") {
      ...productInformation
    }
  }
  
  fragment productInformation on Product {
    totalInventory
    priceRangeV2 {
      minVariantPrice {
        amount
      }
      maxVariantPrice {
        amount
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  Glasses: product(id: "gid://shopify/Product/20995642") {
    ...productInformation
  }
  Shoes: product(id: "gid://shopify/Product/910489600") {
    ...productInformation
  }
  Bracelet: product(id: "gid://shopify/Product/108828309") {
    ...productInformation
  }
}

fragment productInformation on Product {
  totalInventory
  priceRangeV2 {
    minVariantPrice {
      amount
    }
    maxVariantPrice {
      amount
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        Glasses: product(id: "gid://shopify/Product/20995642") {
          ...productInformation
        }
        Shoes: product(id: "gid://shopify/Product/910489600") {
          ...productInformation
        }
        Bracelet: product(id: "gid://shopify/Product/108828309") {
          ...productInformation
        }
      }
      
      fragment productInformation on Product {
        totalInventory
        priceRangeV2 {
          minVariantPrice {
            amount
          }
          maxVariantPrice {
            amount
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "Glasses": {
    "totalInventory": 19,
    "priceRangeV2": {
      "minVariantPrice": {
        "amount": "10.0"
      },
      "maxVariantPrice": {
        "amount": "15.0"
      }
    }
  },
  "Shoes": {
    "totalInventory": 4000,
    "priceRangeV2": {
      "minVariantPrice": {
        "amount": "100.0"
      },
      "maxVariantPrice": {
        "amount": "100.0"
      }
    }
  },
  "Bracelet": {
    "totalInventory": 1,
    "priceRangeV2": {
      "minVariantPrice": {
        "amount": "10.0"
      },
      "maxVariantPrice": {
        "amount": "10.0"
      }
    }
  }
}

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query GetProducts {

products(first: 10) {

nodes {

title

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

query GetProducts {
  products(first: 10) {
    nodes {
      id
      title
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query GetProducts { products(first: 10) { nodes { id title } } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }`,
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query GetProducts {
    products(first: 10) {
      nodes {
        id
        title
      }
    }
  }
QUERY

response = client.query(query: query)

Shopify CLI

shopify app execute \
--query \
'query GetProducts {
  products(first: 10) {
    nodes {
      id
      title
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query GetProducts {
        products(first: 10) {
          nodes {
            id
            title
          }
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

JSON

{

"products": {

"nodes": [

{

"id": "gid://shopify/Product/20995642",

"title": "Element"

{

"id": "gid://shopify/Product/108828309",

"title": "Draft"

{

"id": "gid://shopify/Product/121709582",

"title": "Boots"

{

"id": "gid://shopify/Product/440089423",

"title": "IPod Nano - 8GB"

{

"id": "gid://shopify/Product/558169081",

"title": "Unpublished Boots"

{

"id": "gid://shopify/Product/910489600",

"title": "Crafty Shoes"

{

"id": "gid://shopify/Product/912855135",

"title": "SEO Boots"

}

]

}