# Setting Up Your App Embeds

### What Are App Embeds?

App embeds are Shopify theme extensions that inject CrushSuite's compliance UI into your existing theme. They don't replace your theme — they add compliance functionality on top of it. You enable and customize them through Shopify's theme customizer.

CrushSuite includes **four app embeds**:

<table><thead><tr><th>Embed</th><th width="220.67578125">What It Does</th><th>Required?</th></tr></thead><tbody><tr><td><strong>Main CrushSuite App</strong></td><td>Core compliance engine + shipping state selector</td><td><strong>Yes — required</strong></td></tr><tr><td><strong>Entry Pop-Up Modal</strong></td><td>Age verification + state selection on first visit</td><td>Recommended</td></tr><tr><td><strong>Product Page Compliance Details</strong></td><td>Shows shipping availability on product pages</td><td>Recommended</td></tr><tr><td><strong>Collection Page Compliance Settings</strong></td><td>Shows compliance indicators on collection pages</td><td>Recommended</td></tr></tbody></table>

Each embed has its own detailed configuration guide in the Storefront & Checkout section. This page gives you the quick setup to get all four enabled during onboarding.

***

### How to Enable App Embeds

1. In your **Shopify Admin**, click **Online Store** in the left sidebar.
2. Click **Themes**, then click **Customize** on your active theme.
3. In the theme customizer, click the **App Embeds icon** — it's the third icon on the left-side navigation bar (looks like a puzzle piece or plug icon).
4. You'll see CrushSuite's embeds listed. Enable each one:
   * **CS Main** — Toggle **on** (this is mandatory)
   * **CS Entry Modal** — Toggle **on**
   * **CS Product Page** — Toggle **on**
   * **CS Collection** — Toggle **on**
5. Click **Save**.

{% hint style="warning" %}
**The Main CrushSuite App embed must be turned on.** If this embed is disabled, CrushSuite's compliance features will not function on your storefront — customers won't see compliance checks, state selectors, or availability restrictions.
{% endhint %}

<figure><img src="/files/EOuY0R4CTf6bWZeaVviR" alt=""><figcaption></figcaption></figure>

***

### Quick Customization

Each embed has customization options (colors, text, positioning) that you can adjust right in the theme customizer. For now, the defaults work well for most stores. When you're ready to fine-tune, see the detailed guides:

* Main CrushSuite App Embed
* Entry Pop-Up Modal Embed
* Product Page Compliance Details Embed
* Collection Page Compliance Settings Embed


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://crushsuite.gitbook.io/docs/compliance/getting-started/setting-up-your-app-embeds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.