# Main CrushSuite App Embed (Required)

***

### 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="/files/44Q3Lj2e9FO2BpY0mlJm" 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="/files/xEswApt3tda6n5pcvHbf" 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.


---

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