> For the complete documentation index, see [llms.txt](https://awecommerce.gitbook.io/awe-seasonal-effects/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://awecommerce.gitbook.io/awe-seasonal-effects/getting-started/enable-app-embed.md).

# Enable the app embed

Turn on the AWE app embed in your theme so effects can show.

Nothing the app does reaches your storefront until the **app embed** is on in your theme. It's a one-time step right after installing.

## 🛠️ Steps

{% stepper %}
{% step %}

### Open the setup guide

In the app, go to **Home**. In the **Setup guide**, open **Turn on the app embed** and click **Turn on app embed**.

<figure><img src="https://2143911517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh99vPHicsa9fNoUu2h0S%2Fuploads%2Fgit-blob-ffa81c03d9badd3a44b2113c181d36c72c983022%2Fenable-app-embed-01-setup-guide.png?alt=media" alt="Setup guide on the app Home page"><figcaption></figcaption></figure>

→ *You can also click **Activate** on the "AWE Seasonal Effects is not activated yet." banner.*
{% endstep %}

{% step %}

### Open your theme editor

Click **Open theme editor**. Your live theme opens in a new tab, on **App embeds**.

<figure><img src="https://2143911517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh99vPHicsa9fNoUu2h0S%2Fuploads%2Fgit-blob-bb9f8baccb63205220382cc0454947cfc9ec5a71%2Fenable-app-embed-02-open-theme-editor.png?alt=media" alt="Open theme editor button in the app embed setup dialog"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Switch the app on and save

Turn on **AWE Seasonal Effects**.

<figure><img src="https://2143911517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh99vPHicsa9fNoUu2h0S%2Fuploads%2Fgit-blob-6fac65abdc777deeedf23b3b4fa3b46139ee016d%2Fenable-app-embed-theme-01-toggle.png?alt=media" alt="AWE Seasonal Effects app embed switched on in the theme editor"><figcaption></figcaption></figure>

Then click **Save** (top right).

<figure><img src="https://2143911517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh99vPHicsa9fNoUu2h0S%2Fuploads%2Fgit-blob-364399533df7c0585d9002298146469e296d6142%2Fenable-app-embed-theme-02-save.png?alt=media" alt="Save button at the top right of the theme editor"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Come back to the app

Return to the app tab — the status updates on its own and the step is ticked.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
The app checks your **published** theme. If you switch to a new theme, turn the app embed on in that theme too.
{% endhint %}

## How to tell the embed is off

* **Home** shows the banner *"AWE Seasonal Effects is not activated yet."*
* **Campaigns** shows *"Nothing is showing on your storefront"* and an **Embed required** button.
* The editor **Preview** says *"App embed is off — a real shopper would see none of this"*.

A campaign can say **Active** while the embed is off, but shoppers see nothing. Click **Activate** (Home) or **Turn it on** (Campaigns) to fix it.

***

💬 If you have any related questions, please contact us via **Live chat** in the app.
