Choose a version:

Blog

object

Requires unauthenticated_read_content access scope.

A blog container for Article objects. Stores can have multiple blogs, for example to organize content by topic or purpose.

Each blog provides access to its articles, contributing ArticleAuthor objects, and SEO information. You can retrieve articles individually by handle or as a paginated list.

Anchor to FieldsFields

Anchor to articleByHandlearticleByHandle

•Article

Find an article by its handle.

Anchor to handlehandle •String! required: The handle of the article.

Anchor to articlesarticles

•ArticleConnection!

non-null

List of the blog's articles.

Arguments

Anchor to firstfirst

•Int

Returns up to the first n elements from the list.

Anchor to afterafter

•String

Returns the elements that come after the specified cursor.

Anchor to lastlast

•Int

Returns up to the last n elements from the list.

Anchor to beforebefore

•String

Returns the elements that come before the specified cursor.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

Anchor to sortKeysortKey

•ArticleSortKeys

Default:ID

Sort the underlying list by the given key.

Anchor to queryquery

•String

Apply one or multiple filters to the query. Refer to the detailed search syntax for more information about using filters.

Anchor to author •
Anchor to blog_title •
Anchor to created_at •
Anchor to tag •
Anchor to tag_not •
Anchor to updated_at •

Anchor to authorsauthors

•[ArticleAuthor!]!

non-null

The authors who have contributed to the blog.

Anchor to handlehandle

•String!

non-null

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

Anchor to idid

•ID!

non-null

A globally-unique ID.

Anchor to metafieldmetafield

•Metafield

A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

Anchor to namespacenamespace •String: The container the metafield belongs to. If omitted, the app-reserved namespace will be used.
Anchor to keykey •String! required: The identifier for the metafield.

Anchor to metafieldsmetafields

•[Metafield]!

non-null

A list of custom fields that a merchant associates with a Shopify resource.

Arguments

Anchor to identifiersidentifiers

•[HasMetafieldsIdentifier!]!

required

The list of metafields to retrieve by namespace and key.

The input must not contain more than 250 values.

Anchor to onlineStoreUrlonlineStoreUrl

•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.

Anchor to seoseo

•SEO

The blog's SEO information.

Anchor to titletitle

•String!

non-null

The blogs’s title.

Was this section helpful?

Anchor to QueriesQueries

Anchor to blog blog

•query

Retrieves a Blog by its handle or ID. A blog organizes Article objects for the online store and includes author information, SEO settings, and custom Metafield objects.