Choose a version:

blog

query

Returns a Blog resource by ID.

Anchor to Arguments

Arguments

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

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to BlogBlog •Blog: A blog for publishing articles in the online store. Stores can have multiple blogs to organize content by topic or purpose.

Each blog contains articles with their associated comments, tags, and metadata. The comment policy controls whether readers can post comments and whether moderation is required. Blogs use customizable URL handles and can apply alternate templates for specialized layouts.

Was this section helpful?

Examples

Receive a single Blog

Query

query BlogShow($id: ID!) {
  blog(id: $id) {
    id
    title
    handle
  }
}

Variables

{
  "id": "gid://shopify/Blog/397675442"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query BlogShow($id: ID!) { blog(id: $id) { id title handle } }",
 "variables": {
    "id": "gid://shopify/Blog/397675442"
  }
}'

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 BlogShow($id: ID!) {
    blog(id: $id) {
      id
      title
      handle
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Blog/397675442"
    },
  },
  );
  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 BlogShow($id: ID!) {
    blog(id: $id) {
      id
      title
      handle
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Blog/397675442"
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query BlogShow($id: ID!) {
      blog(id: $id) {
        id
        title
        handle
      }
    }`,
    "variables": {
        "id": "gid://shopify/Blog/397675442"
    },
  },
});

Response

{
  "blog": {
    "id": "gid://shopify/Blog/397675442",
    "title": "Yo Blog",
    "handle": "smallcheese-blog"
  }
}

Retrieves a count of all articles from a blog

Query

query BlogArticleCount($id: ID!) {
  blog(id: $id) {
    articlesCount {
      count
      precision
    }
  }
}

Variables

{
  "id": "gid://shopify/Blog/397675442"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query BlogArticleCount($id: ID!) { blog(id: $id) { articlesCount { count precision } } }",
 "variables": {
    "id": "gid://shopify/Blog/397675442"
  }
}'

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 BlogArticleCount($id: ID!) {
    blog(id: $id) {
      articlesCount {
        count
        precision
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Blog/397675442"
    },
  },
  );
  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 BlogArticleCount($id: ID!) {
    blog(id: $id) {
      articlesCount {
        count
        precision
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Blog/397675442"
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query BlogArticleCount($id: ID!) {
      blog(id: $id) {
        articlesCount {
          count
          precision
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Blog/397675442"
    },
  },
});

Response

{
  "blog": {
    "articlesCount": {
      "count": 1,
      "precision": "EXACT"
    }
  }
}

Retrieves a list of all articles from a blog

Query

query BlogArticleList($id: ID!) {
  blog(id: $id) {
    id
    articles(first: 10) {
      nodes {
        id
        handle
        author {
          firstName
          lastName
        }
        body
      }
    }
  }
}

Variables

{
  "id": "gid://shopify/Blog/397675442"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query BlogArticleList($id: ID!) { blog(id: $id) { id articles(first: 10) { nodes { id handle author { firstName lastName } body } } } }",
 "variables": {
    "id": "gid://shopify/Blog/397675442"
  }
}'

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 BlogArticleList($id: ID!) {
    blog(id: $id) {
      id
      articles(first: 10) {
        nodes {
          id
          handle
          author {
            firstName
            lastName
          }
          body
        }
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Blog/397675442"
    },
  },
  );
  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 BlogArticleList($id: ID!) {
    blog(id: $id) {
      id
      articles(first: 10) {
        nodes {
          id
          handle
          author {
            firstName
            lastName
          }
          body
        }
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Blog/397675442"
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query BlogArticleList($id: ID!) {
      blog(id: $id) {
        id
        articles(first: 10) {
          nodes {
            id
            handle
            author {
              firstName
              lastName
            }
            body
          }
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Blog/397675442"
    },
  },
});

Response

{
  "blog": {
    "id": "gid://shopify/Blog/397675442",
    "articles": {
      "nodes": [
        {
          "id": "gid://shopify/Article/959752435",
          "handle": "you-should-buy-this",
          "author": {
            "firstName": "",
            "lastName": ""
          },
          "body": "<p>Go for it, get three.</p>"
        }
      ]
    }
  }
}

Examples

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 BlogShow($id: ID!) {

blog(id: $id) {

title

handle

}

}`,

{

variables: {

"id": "gid://shopify/Blog/397675442"

);

const json = await response.json();

return json.data;

}

GQL

query BlogShow($id: ID!) {
  blog(id: $id) {
    id
    title
    handle
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query BlogShow($id: ID!) { blog(id: $id) { id title handle } }",
 "variables": {
    "id": "gid://shopify/Blog/397675442"
  }
}'

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 BlogShow($id: ID!) {
    blog(id: $id) {
      id
      title
      handle
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Blog/397675442"
    },
  },
  );
  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 BlogShow($id: ID!) {
      blog(id: $id) {
        id
        title
        handle
      }
    }`,
    "variables": {
        "id": "gid://shopify/Blog/397675442"
    },
  },
});

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 BlogShow($id: ID!) {
    blog(id: $id) {
      id
      title
      handle
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Blog/397675442"
}

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

Input variables

JSON

{

"id": "gid://shopify/Blog/397675442"

}

Response

JSON

{

"blog": {

"id": "gid://shopify/Blog/397675442",

"title": "Yo Blog",

"handle": "smallcheese-blog"

}