Version 2019-10

A theme controls the look and feel of a Shopify online store.

A store can have a maximum of 20 themes, one of which is the published theme that customers see when they visit the online store. Customers can't see unpublished themes. When you publish a theme, the previously published theme becomes unpublished.

To modify the files of a theme after it has been uploaded, use the Asset resource. To learn how to create your own theme, see Building themes

What you can do with Theme

The Shopify API lets you do the following with the Theme resource. More detailed versions of these general actions may be available:

Theme properties

"created_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the theme was created.

"id": 828155753

A unique numeric identifier for the theme.

"name": "Comfort"

The name of the theme.

"previewable": true

Whether the theme can currently be previewed.

"processing": true

Whether files are still being copied into place for this theme.

"role": "main"

Specifies how the theme is being used within the shop. Valid values:

  • main: The theme is published. Customers see it when they visit the online store.
  • unpublished: The theme is unpublished. Customers can't see it.
  • demo: The theme is installed on the store as a demo. The theme can't be published until the merchant buys the full version.