Choose a version:

article

query

Returns a Article resource by ID.

Anchor to Arguments

Arguments

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

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to ArticleArticle •Article: An article that contains content, author information, and metadata. Articles belong to a Blog and can include HTML-formatted body text, summary text, and an associated image. Merchants publish articles to share content, drive traffic, and engage customers.

Articles can be organized with tags and published immediately or scheduled for future publication using the publishedAt timestamp. The API manages comments on articles when the blog's comment policy enables them.

Was this section helpful?

Examples

Receive a single Article

Query

query ArticleShow($id: ID!) {
  article(id: $id) {
    id
    author {
      name
    }
    createdAt
    handle
  }
}

Variables

{
  "id": "gid://shopify/Article/959752435"
}

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 ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }",
 "variables": {
    "id": "gid://shopify/Article/959752435"
  }
}'

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 ArticleShow($id: ID!) {
    article(id: $id) {
      id
      author {
        name
      }
      createdAt
      handle
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Article/959752435"
    },
  },
  );
  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 ArticleShow($id: ID!) {
    article(id: $id) {
      id
      author {
        name
      }
      createdAt
      handle
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Article/959752435"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query ArticleShow($id: ID!) {
      article(id: $id) {
        id
        author {
          name
        }
        createdAt
        handle
      }
    }`,
    "variables": {
        "id": "gid://shopify/Article/959752435"
    },
  },
});

Response

{
  "article": {
    "id": "gid://shopify/Article/959752435",
    "author": {
      "name": "dennis"
    },
    "createdAt": "2012-01-01T00:00:00Z",
    "handle": "you-should-buy-this"
  }
}

Receive a single Article

Open in GraphiQL

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

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

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

const response = await admin.graphql(

`#graphql

query ArticleShow($id: ID!) {

article(id: $id) {

author {

name

}

createdAt

handle

}

}`,

{

variables: {

"id": "gid://shopify/Article/959752435"

);

const json = await response.json();

return json.data;

}

GQL

query ArticleShow($id: ID!) {
  article(id: $id) {
    id
    author {
      name
    }
    createdAt
    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 ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }",
 "variables": {
    "id": "gid://shopify/Article/959752435"
  }
}'

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 ArticleShow($id: ID!) {
    article(id: $id) {
      id
      author {
        name
      }
      createdAt
      handle
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Article/959752435"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query ArticleShow($id: ID!) {
      article(id: $id) {
        id
        author {
          name
        }
        createdAt
        handle
      }
    }`,
    "variables": {
        "id": "gid://shopify/Article/959752435"
    },
  },
});

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 ArticleShow($id: ID!) {
    article(id: $id) {
      id
      author {
        name
      }
      createdAt
      handle
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Article/959752435"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/Article/959752435"

}

Response

JSON

{

"article": {

"id": "gid://shopify/Article/959752435",

"author": {

"name": "dennis"

"createdAt": "2012-01-01T00:00:00Z",

"handle": "you-should-buy-this"

}