---
title: articles - Storefront API
description: >
  Returns a paginated list of
  [`Article`](/docs/api/storefront/2026-01/objects/Article) objects from the
  shop's [`Blog`](/docs/api/storefront/2026-01/objects/Blog) objects. Each
  article is a blog post containing content, author information, tags, and
  optional images.


  Use the `query` argument to filter results by author, blog title, tags, or
  date fields. Sort results using the `sortKey` argument and reverse them with
  the `reverse` argument.
api_version: 2026-01
api_name: storefront
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/articles'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/articles.md'
---

# articles

query

Returns a paginated list of [`Article`](https://shopify.dev/docs/api/storefront/2026-01/objects/Article) objects from the shop's [`Blog`](https://shopify.dev/docs/api/storefront/2026-01/objects/Blog) objects. Each article is a blog post containing content, author information, tags, and optional images.

Use the `query` argument to filter results by author, blog title, tags, or date fields. Sort results using the `sortKey` argument and reverse them with the `reverse` argument.

## ArticleConnection arguments

[ArticleConnection!](https://shopify.dev/docs/api/storefront/latest/connections/ArticleConnection)

* after

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  Returns the elements that come after the specified cursor.

* before

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  Returns the elements that come before the specified cursor.

* first

  [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

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

* last

  [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

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

* query

  [String](https://shopify.dev/docs/api/storefront/latest/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

* reverse

  [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean)

  Default:false

  Reverse the order of the underlying list.

* sort​Key

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

  Default:ID

  Sort the underlying list by the given key.

***

## Possible returns

* edges

  [\[Article​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/ArticleEdge)

  non-null

  A list of edges.

* nodes

  [\[Article!\]!](https://shopify.dev/docs/api/storefront/latest/objects/Article)

  non-null

  A list of the nodes contained in ArticleEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Examples

* ### articles reference