> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/options/settings/theme-setup.md).

# Theme setup

Choose which theme to work with, and turn the app embed on or off for it.

**Settings** > **Theme Setup** is where you confirm that the app is turned on in the right theme.

## What is on the page

<table><thead><tr><th width="230">Element</th><th>What it does</th></tr></thead><tbody><tr><td>Theme selector</td><td>Lists every theme in your store. Your published theme is marked <strong>(Live theme)</strong></td></tr><tr><td><strong>App embed</strong> badge</td><td><strong>Activated</strong> or <strong>Deactivated</strong> for the selected theme</td></tr><tr><td><strong>Go to Theme Editor</strong></td><td>Appears when the selected theme shows <strong>Deactivated</strong>. Opens the Shopify theme editor at the app embed</td></tr></tbody></table>

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-3d185fe6f12b6a50ee50c60206ce4c251124325e%2F2026-09-07_11-49-06.png?alt=media" alt="The Theme Setup page with a theme selected and its app embed status"><figcaption><p>Select a theme, and the badge tells you whether the app is running on it.</p></figcaption></figure>

## The app embed

The app embed is what lets the app run on your storefront. Nothing you build is displayed to customers until it is on.

The app embed is **per theme**. Enabling it on one theme does not affect the others, so when you publish a new theme, including a duplicate of the same theme, you have to enable it again.

For full instructions, including two other ways to do this, see [Enable the app embed](/options/getting-started/enable-the-app-embed.md).

## Checking a theme before you publish it

Use the theme selector to check a theme you are **about to** publish.

{% stepper %}
{% step %}

### Select the draft theme

Select it from the theme selector.
{% endstep %}

{% step %}

### Read the badge

If the badge says **Deactivated**, your options disappear as soon as you publish that theme.
{% endstep %}

{% step %}

### Enable it now

Select **Go to Theme Editor**, turn the app embed on, and save.
{% endstep %}

{% step %}

### Preview the draft theme

Check a product page on the draft theme before you publish it.
{% endstep %}
{% endstepper %}

Doing this before a theme launch prevents options from disappearing from your live store immediately after a redesign.

## Notes

* Enabling the embed does not edit theme files. Shopify stores it with the theme.
* Turning it off is a way to disable the app across your storefront without uninstalling it.
* The badge updates automatically when you return from the theme editor, because the app checks again when the tab becomes visible.
* The **Dashboard** displays the same status, along with a count of any [app blocks](/options/getting-started/add-the-app-block.md) you have placed.