---
title: OnlineStoreTheme - GraphQL Admin
description: A theme for display on the storefront.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme.md
---

# Online​Store​Theme

object

Requires `read_themes` access scope.

A theme for display on the storefront.

## Fields

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the theme was created.

* files

  [Online​Store​Theme​File​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/OnlineStoreThemeFileConnection)

  The files in the theme.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* name

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The name of the theme, set by the merchant.

* prefix

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The prefix of the theme.

* processing

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the theme is processing.

* processing​Failed

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the theme processing failed.

* role

  [Theme​Role!](https://shopify.dev/docs/api/admin-graphql/latest/enums/ThemeRole)

  non-null

  The role of the theme.

* theme​Store​Id

  [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  The theme store ID.

* translations

  [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation)

  non-null

  The published translations associated with the resource.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the theme was last updated.

***

## Map

### Fields and connections with this object

* <->[OnlineStoreThemeConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/OnlineStoreThemeConnection#returns-nodes)
* {}[OnlineStoreThemeEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeEdge#field-OnlineStoreThemeEdge.fields.node)

***

## Queries

* [theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme)

  query

  Returns a particular theme for the shop.

* [themes](https://shopify.dev/docs/api/admin-graphql/latest/queries/themes)

  query

  Returns a paginated list of themes for the shop.

***

## \<?>OnlineStoreTheme Queries

### Queried by

* \<?>[theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme)
* \<?>[themes](https://shopify.dev/docs/api/admin-graphql/latest/queries/themes)

***

## Mutations

* [theme​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeCreate)

  mutation

  Creates a theme using an external URL or for files that were previously uploaded using the [stagedUploadsCreate mutation](https://shopify.dev/api/admin-graphql/latest/mutations/stageduploadscreate). These themes are added to the [Themes page](https://admin.shopify.com/themes) in Shopify admin.

* [theme​Duplicate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeDuplicate)

  mutation

  Duplicates a theme.

* [theme​Publish](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themePublish)

  mutation

  Publishes a theme.

* [theme​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeUpdate)

  mutation

  Updates a theme.

***

## <\~> OnlineStoreTheme Mutations

### Mutated by

* <\~>[theme​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeCreate)
* <\~>[theme​Duplicate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeDuplicate)
* <\~>[theme​Publish](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themePublish)
* <\~>[theme​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeUpdate)

***

## Interfaces

* * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

    interface

***

## ||-OnlineStoreTheme Implements

### Implements

* ||-[Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)