# Product Page Compliance Details Embed

***

### What This Embed Does

When enabled, this embed adds compliance information to every wine product page:

* A **cannot-purchase message** when the product can't ship to the customer's selected state
* An optional **list of available shipping states** so customers can see where the product ships
* The display updates automatically when the customer changes their shipping state

***

### Customization Options

| Setting                      | What It Controls                                                  | Default                               |
| ---------------------------- | ----------------------------------------------------------------- | ------------------------------------- |
| **Cannot Purchase Message**  | Text shown when a product is unavailable for the customer's state | "Shipping unavailable to your state." |
| **Display Available States** | Toggle to show/hide the list of states the product can ship to    | On                                    |
| **States List Position**     | Where the shipping states display appears on the product page     | Under the "Add to Cart" button        |

#### States List Position Options

* **Under the "Add to Cart" button** — most common, keeps compliance info near the purchase action
* **Under the main product section** — below the product description
* **Above the main product section** — at the top of the product details

***

### 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 Product Page"** (or "Product Page Compliance") and toggle it **on**.
4. Click on the embed to expand its settings:
   * Edit the **Cannot Purchase Message** text
   * Toggle **Display Available States** on or off
   * Choose the **States List Position**
5. **Navigate to a product page** within the customizer to preview your changes.
6. Click **Save**.

{% hint style="info" %}
**Preview on a product page.** To see your changes in the customizer, navigate to an actual product page using the page selector at the top of the customizer. The product page compliance elements won't show on the homepage or collection pages.
{% endhint %}

<figure><img src="/files/4M7yMqtktxK932ecyUxD" alt=""><figcaption></figcaption></figure>

***

### How It Looks to Customers

#### Product IS available for their state

The customer sees normal product page with "Add to Cart" enabled. If you've enabled the states list, they can expand it to see all shipping destinations.

#### Product is NOT available for their state

The customer sees:

* Your **cannot-purchase message** prominently displayed
* The "Add to Cart" button may be disabled or replaced with the compliance message
* If the states list is enabled, the customer can see which states the product does ship to

***

### Best Practices

* **Write a helpful cannot-purchase message.** Instead of a generic "unavailable," explain why: "We're unable to ship this wine to \[state] due to state regulations." This builds trust and reduces support inquiries.
* **Keep the states list enabled.** Customers appreciate seeing where you can ship. It answers the question before they ask it.
* **Position under "Add to Cart."** This keeps the compliance info close to the action — the customer sees availability right where they'd make a purchase decision.


---

# 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/product-page-compliance-details-embed.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.