Choose a version:

node

query

Returns a specific node (any object that implements the Node interface) by ID, in accordance with the Relay specification. This field is commonly used for refetching an object.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The ID of the Node to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to NodeNode

•Node

An object with an ID field to support global identification, in accordance with the Relay specification. This interface is used by the node and nodes queries.

Show fields

Anchor to idid •ID! non-null: A globally-unique ID.

Was this section helpful?

Examples

Retrieve a product using a node query

Description

The following query retrieves a product using its ID.

Query

query {
  node(id: "gid://shopify/Product/108828309") {
    id
    ... on Product {
      title
      handle
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { node(id: \"gid://shopify/Product/108828309\") { id ... on Product { title handle } } }"
}'

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 {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }`,
  );
  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 {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query {
  node(id: "gid://shopify/Product/108828309") {
    id
    ... on Product {
      title
      handle
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/unstable/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        node(id: "gid://shopify/Product/108828309") {
          id
          ... on Product {
            title
            handle
          }
        }
      }
    `,
  }),
});

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

Response

{
  "node": {
    "id": "gid://shopify/Product/108828309",
    "title": "Draft",
    "handle": "draft"
  }
}

Retrieve a product using a node query

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

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

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

const response = await admin.graphql(

`#graphql

query {

node(id: "gid://shopify/Product/108828309") {

... on Product {

title

handle

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

query {
  node(id: "gid://shopify/Product/108828309") {
    id
    ... on Product {
      title
      handle
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { node(id: \"gid://shopify/Product/108828309\") { id ... on Product { title handle } } }"
}'

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 {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }`,
});

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 {
    node(id: "gid://shopify/Product/108828309") {
      id
      ... on Product {
        title
        handle
      }
    }
  }
QUERY

response = client.query(query: query)

Shopify CLI

shopify app execute \
--query \
'query {
  node(id: "gid://shopify/Product/108828309") {
    id
    ... on Product {
      title
      handle
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/unstable/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query {
        node(id: "gid://shopify/Product/108828309") {
          id
          ... on Product {
            title
            handle
          }
        }
      }
    `,
  }),
});

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

Response

JSON

{

"node": {

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

"title": "Draft",

"handle": "draft"

}