---
title: Article - GraphQL Admin
description: >-
  An article that contains content, author information, and metadata. Articles
  belong to a
  [`Blog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article#field-Article.fields.publishedAt)
  timestamp. The API manages comments on articles when the blog's comment policy
  enables them.
api_version: unstable
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Article'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Article.md'
---

# Article

object

Requires `read_content` access scope or `read_online_store_pages` access scope.

An article that contains content, author information, and metadata. Articles belong to a [`Blog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article#field-Article.fields.publishedAt) timestamp. The API manages comments on articles when the blog's comment policy enables them.

## Fields

* author
* blog
* body
* comments
* commentsCount
* createdAt
* defaultCursor
* events
* handle
* id
* image
* isPublished
* metafield
* metafields
* metafieldsByIdentifiers
* publishedAt
* summary
* tags
* templateSuffix
* title
* translations
* updatedAt
* metafieldDefinitions: deprecated

***

## Map

### Fields and connections with this object

* [ArticleConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/ArticleConnection#returns-nodes)
* [ArticleEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ArticleEdge#field-ArticleEdge.fields.node)
* [Blog.articles](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Blog#field-Blog.fields.articles)
* [Comment.article](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Comment#field-Comment.fields.article)

### Possible type in

* [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/unstable/unions/MetafieldReference)
* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/unstable/unions/MetafieldReferencer)

***

## Queries

* article
* articles

***

## Article Queries

### Queried by

* [article](https://shopify.dev/docs/api/admin-graphql/unstable/queries/article)
* [articles](https://shopify.dev/docs/api/admin-graphql/unstable/queries/articles)

***

## Mutations

* articleCreate
* articleUpdate

***

## Article Mutations

### Mutated by

* [article​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/articleCreate)
* [article​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/articleUpdate)

***

## Interfaces

* HasEvents
* HasMetafieldDefinitions
* HasMetafields
* HasPublishedTranslations
* Navigable
* Node

***

## Article Implements

### Implements

* [Has​Events](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasEvents)
* [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafieldDefinitions)
* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields)
* [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasPublishedTranslations)
* [Navigable](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Navigable)
* [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)