---
title: articles - Storefront API
description: List of the shop's articles.
api_version: 2025-10
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

List of the shop's articles.

## 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

## Query Reference

```graphql
{
  articles {
    # articles fields
  }
}
```