---
title: blog - Storefront API
description: Fetch a specific `Blog` by one of its unique attributes.
api_version: 2025-04
api_name: storefront
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/2025-04/queries/blog'
  md: 'https://shopify.dev/docs/api/storefront/2025-04/queries/blog.md'
---

# blog

query

Fetch a specific `Blog` by one of its unique attributes.

## Arguments

* handle

  [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

  The handle of the `Blog`.

* id

  [ID](https://shopify.dev/docs/api/storefront/2025-04/scalars/ID)

  The ID of the `Blog`.

***

## Possible returns

* Blog

  [Blog](https://shopify.dev/docs/api/storefront/2025-04/objects/Blog)

  An online store blog.

  * article​By​Handle

    [Article](https://shopify.dev/docs/api/storefront/2025-04/objects/Article)

    Find an article by its handle.

    * handle

      [String!](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      required

      ### Arguments

      The handle of the article.

    ***

  * articles

    [Article​Connection!](https://shopify.dev/docs/api/storefront/2025-04/connections/ArticleConnection)

    non-null

    List of the blog's articles.

    * first

      [Int](https://shopify.dev/docs/api/storefront/2025-04/scalars/Int)

      ### Arguments

      Returns up to the first `n` elements from the list.

    * after

      [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      Returns the elements that come after the specified cursor.

    * last

      [Int](https://shopify.dev/docs/api/storefront/2025-04/scalars/Int)

      Returns up to the last `n` elements from the list.

    * before

      [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      Returns the elements that come before the specified cursor.

    * reverse

      [Boolean](https://shopify.dev/docs/api/storefront/2025-04/scalars/Boolean)

      Default:false

      Reverse the order of the underlying list.

    * sort​Key

      [Article​Sort​Keys](https://shopify.dev/docs/api/storefront/2025-04/enums/ArticleSortKeys)

      Default:ID

      Sort the underlying list by the given key.

    * query

      [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      Apply one or multiple filters to the query. Refer to the detailed [search syntax](https://shopify.dev/api/usage/search-syntax) for more information about using filters.

      * author
      * blog\_title
      * created\_at
      * tag
      * tag\_not
      * updated\_at

    ***

  * authors

    [\[Article​Author!\]!](https://shopify.dev/docs/api/storefront/2025-04/objects/ArticleAuthor)

    non-null

    The authors who have contributed to the blog.

  * handle

    [String!](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

    non-null

    A human-friendly unique string for the Blog automatically generated from its title.

  * id

    [ID!](https://shopify.dev/docs/api/storefront/2025-04/scalars/ID)

    non-null

    A globally-unique ID.

  * metafield

    [Metafield](https://shopify.dev/docs/api/storefront/2025-04/objects/Metafield)

    A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

    * namespace

      [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      ### Arguments

      The container the metafield belongs to. If omitted, the app-reserved namespace will be used.

    * key

      [String!](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

      required

      The identifier for the metafield.

    ***

  * metafields

    [\[Metafield\]!](https://shopify.dev/docs/api/storefront/2025-04/objects/Metafield)

    non-null

    A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

    * identifiers

      [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/storefront/2025-04/input-objects/HasMetafieldsIdentifier)

      required

      ### Arguments

      The list of metafields to retrieve by namespace and key.

      The input must not contain more than `250` values.

    ***

  * online​Store​Url

    [URL](https://shopify.dev/docs/api/storefront/2025-04/scalars/URL)

    The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel.

  * seo

    [SEO](https://shopify.dev/docs/api/storefront/2025-04/objects/SEO)

    The blog's SEO information.

  * title

    [String!](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

    non-null

    The blogs’s title.

***

## Examples

* ### blog reference

## Query Reference

```graphql
{
  blog {
    # blog fields
  }
}
```