> 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/storefront-and-checkout/main-crushsuite-app-embed-required.md).

# Main CrushSuite App Embed (Required)

The Main CrushSuite App embed is the core of CrushSuite's storefront functionality. It powers the compliance engine, the shipping state selector button, and enables all other embeds to work. This embe

***

### What This Embed Does

The Main CrushSuite App embed provides two critical functions:

1. **Compliance engine** — Runs all state compliance checks, product availability filtering, and fee calculations in the background. Without this, none of CrushSuite's compliance features work.
2. **Shipping state selector button** — A floating button featuring a map of the United States that allows customers to change their shipping state while browsing. When a customer clicks this button and selects a different state, product availability updates in real time.

<figure><img src="https://3906158595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FagSKdREExJMSW7WgxBLr%2Fuploads%2FFenFz1B5AqPW9wkepWFg%2FCleanShot%202026-03-12%20at%2014.11.55.png?alt=media&amp;token=02f4d9ab-f52b-4216-b95d-43461d198ff7" alt=""><figcaption></figcaption></figure>

***

### The Shipping State Button

#### Why it matters

The shipping button gives customers visibility into which products are available for their location while they browse. Without it, a customer might add products to their cart only to discover at checkout that some can't be shipped to their state. The button lets them check availability upfront.

#### Where it appears

The button is a floating icon that stays visible as the customer scrolls through your store. You can position it in any corner of the screen.

#### Customization options

| Setting        | Options                                        | Default          |
| -------------- | ---------------------------------------------- | ---------------- |
| **Visibility** | On / Off                                       | On (recommended) |
| **Color**      | Any hex color                                  | Theme default    |
| **Position**   | Top Left, Top Right, Bottom Left, Bottom Right | Bottom Right     |

While you can turn the shipping button off, we recommend keeping it enabled. It's a small UI element that provides significant value for the customer experience.

***

### How to Enable and Customize

1. In your **Shopify Admin**, click **Online Store** → **Themes** → **Customize**.
2. Click the **App Embeds icon** (third icon on the left navigation bar).
3. Find **"CS Main"** (or "Main CrushSuite") in the list and toggle it **on**.
4. Click on the embed to expand its customization settings:
   * **Shipping Button** — toggle on/off
   * **Color** — pick a color that matches your branding
   * **Position** — choose the screen corner
5. Click **Save**.

<figure><img src="https://3906158595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FagSKdREExJMSW7WgxBLr%2Fuploads%2F7J5O6vCuNVFQ7Xw1BPI4%2FCleanShot%202026-03-12%20at%2014.12.32.png?alt=media&amp;token=b75ed93d-e8bb-4cae-9848-7b6dc3d062be" alt=""><figcaption></figcaption></figure>

***

### Important Notes

{% hint style="warning" %}
**This embed must be turned on.** Disabling the Main CrushSuite App embed disables all CrushSuite compliance features on your storefront. Products will not be filtered by state, fees will not be calculated, and the other embeds (Entry Modal, Product Page, Collection Page) will not function.
{% endhint %}

If your compliance features suddenly stop working, the first thing to check is whether this embed is still enabled in your theme customizer.