# 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 compatible

Some heavily customized themes may not support app embeds correctly.

1. Test with a default Shopify theme (like Dawn) to see if embeds work there.
2. If they do, the issue is theme-specific. Contact your theme developer or CrushSuite support.

#### 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


---

# 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/troubleshooting/app-embed-not-displaying.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.