Skip to main content
query

Requires read_themes access scope.

Returns an OnlineStoreTheme by its ID. Use this query to retrieve theme metadata and access the theme's files, which include templates, assets, translations, and configuration files.

•ID!
required

The ID of the theme.


Was this section helpful?

•OnlineStoreTheme

A theme for display on the storefront. Themes control the visual appearance and functionality of the online store through templates, stylesheets, and assets that determine how products, collections, and other content display to customers.

Each theme has a role that indicates its status. Main themes are live on the storefront, unpublished themes are inactive, demo themes require purchase before publishing, and development themes are temporary for previewing during development. The theme includes translations for multi-language support.

•DateTime!
non-null

The date and time when the theme was created.

•OnlineStoreThemeFileConnection

The files in the theme.

Arguments

•[String!]

The filenames of the theme files. At most 50 filenames can be specified. Use '*' to match zero or more characters.

•Int
Default:50

Returns at most the first n files for this theme. Fewer than n files may be returned to stay within the payload size limit, or when the end of the list is reached. At most 2500 can be fetched at once.

•String

A cursor for use in pagination.


•ID!
non-null

A globally-unique ID.

•String!
non-null

The name of the theme, set by the merchant.

•String!
non-null

The prefix of the theme.

•Boolean!
non-null

Whether the theme is processing.

•Boolean!
non-null

Whether the theme processing failed.

•ThemeRole!
non-null

The role of the theme.

•Int

The theme store ID.

•[Translation!]!
non-null

The published translations associated with the resource.

Arguments

•String!
required

Filters translations locale.

•ID

Filters translations by market ID. Use this argument to retrieve content specific to a market.


•DateTime!
non-null

The date and time when the theme was last updated.


Was this section helpful?