---
title: OnlineStoreTheme - GraphQL Admin
description: >-
  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](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product),
  [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection),
  and other content display to customers.


  Each theme has a
  [role](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme#field-OnlineStoreTheme.fields.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](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme#field-OnlineStoreTheme.fields.translations)
  for multi-language support.
api_version: 2026-01
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. Themes control the visual appearance and functionality of the online store through templates, stylesheets, and assets that determine how [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product), [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection), and other content display to customers.

Each theme has a [role](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme#field-OnlineStoreTheme.fields.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](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme#field-OnlineStoreTheme.fields.translations) for multi-language support.

## Fields

* createdAt
* files
* id
* name
* prefix
* processing
* processingFailed
* role
* themeStoreId
* translations
* updatedAt

***

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

***

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

* themeCreate
* themeDuplicate
* themePublish
* themeUpdate

***

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

* HasPublishedTranslations
* Node

***

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