> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/app-embed-not-displaying.md).

# App Embed Not Displaying

If CrushSuite's compliance features aren't appearing on your storefront — no entry modal, no shipping button, no compliance badges — the issue is usually with your app embed configuration.

### Symptoms

* No entry pop-up modal on first visit
* Shipping button not visible
* No compliance badges on product or collection pages
* Compliance checks not running at checkout

### Common Causes and Solutions

#### Main CrushSuite App embed is off

This is the most common cause. The Main CrushSuite App embed must be enabled for any compliance features to work.

1. Go to **Online Store** → **Themes** → **Customize**.
2. Click the **App Embeds** icon.
3. Find **Main CrushSuite App** and ensure it's toggled **on**.
4. Save.

#### Theme not supported

CrushSuite's storefront embeds are built and tested against Shopify's **Dawn** and **Horizon** themes. Other themes — including third-party and heavily customized themes — may place the cart and checkout elements CrushSuite depends on in ways it cannot detect. Symptoms are missing compliance badges, a bypassable entry modal, or a checkout button that skips the compliance gate.

1. Duplicate your theme and switch the copy to **Dawn** or **Horizon**, then test whether the embeds work there.
2. If they do, the issue is specific to your theme. Contact support — we can sometimes patch around a specific theme, but be aware that such patches do not survive a theme update and will need to be reapplied.

#### Cache issue

Your browser may be showing a cached version of the page.

1. Clear your browser cache or test in an incognito/private window.
2. Hard refresh the page (Ctrl+Shift+R or Cmd+Shift+R).

#### App embed settings conflict

If you have other app embeds from different apps, they may conflict with CrushSuite's embeds.

1. Temporarily disable other app embeds to test.
2. If CrushSuite works with others disabled, contact support to troubleshoot the conflict.

### When to Contact Support

If embeds still don't appear after checking all of the above, contact CrushSuite support with:

* Your Shopify theme name and version
* A list of other installed app embeds
* Screenshots of your App Embeds panel