> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Storefront Setup

> Turn on checkout protection, add the Fanfare Product Widget to your Shopify theme, and customize how it displays.

Installing the Fanfare app is only the first step. Before launching your first drop, two storefront pieces need to be active:

1. **Checkout protection is on:** A server-side Shopify checkout rule blocks any checkout for a protected product unless the shopper gained access through your experience.
2. **The product widget is on your theme:** The **Fanfare Product Widget** block displays your queue, draw, countdown, or auction right on the product page in place of your standard buy buttons.

You need both. As soon as you add a product to an experience—even a **Draft**—checkout protection blocks normal checkouts whether or not the widget is installed. Without the widget, shoppers can't buy the product normally or enter your drop. Without checkout protection, shoppers can bypass your drop completely.

Check the live status of both steps anytime under **Settings → Storefront setup** (also tracked on your **Home** setup checklist).

## Before you start

* The Fanfare app is installed on your store.
* Your Shopify staff account has permission to edit checkout settings and customize your published theme.

## Step 1: Turn on checkout protection

Checkout protection uses a Shopify checkout rule called **Fanfare checkout validation**. Fanfare adds and enables this rule automatically during installation, so on most stores it's already active. Follow these steps if **Storefront setup** shows **Not turned on** or **Turned off**:

**1. Open Checkout rules in Shopify**

In Shopify admin, go to **Settings → Checkout** and scroll to **Checkout rules**.

**2. Add or open the rule**

If **Fanfare checkout validation** isn't listed yet, select **Add rule** and choose it. Otherwise, open the existing rule.

**3. Turn it on and save**

Select **Turn on**, leave **Allow all customers to complete checkout** unchecked, and select **Save**.

> [!WARNING]
>
> Leave **Allow all customers to complete checkout** unchecked. Checking it causes Fanfare to treat checkout protection as off.

Return to Fanfare—**Storefront setup** rechecks automatically and updates to **On**. Fanfare never overwrites a rule you've manually edited, so if you turn it off, it stays off until you turn it back on.

## Step 2: Add the product widget to your theme

The **Fanfare Product Widget** is an app block you add to your Shopify product template.

**1. Open your theme editor from Fanfare**

In Fanfare, go to **Settings → Storefront setup** and select **Add to product page**. Shopify opens your product template in the theme editor with the widget block ready to place.

**2. Place the block**

Drag the **Fanfare Product Widget** block to where your buy buttons appear (typically right below the price).

**3. Save your theme**

Select **Save**.

To add the block manually instead, go to **Online Store → Themes → Customize**, switch to a product template, select **Add block** inside the product information section, and choose **Fanfare Product Widget** under **Apps**.

> [!TIP]
>
> If your store uses multiple product templates for drop items, add the **Fanfare Product Widget** block to every template that sells protected products.

### What the widget changes on the page

Whenever a product belongs to an experience—regardless of status, including before the drop opens and after it ends—the widget automatically hides:

* **Add to cart** and **Buy it now** buttons
* Express checkout buttons (such as Shop Pay and Apple Pay)
* Variant and quantity selectors

Shoppers who earn access select their variant inside the widget and proceed directly to Shopify checkout. Your product title, price, images, and description stay untouched.

Products that aren't part of any experience are unaffected—the widget stays hidden and your theme's normal buy buttons display as usual.

## Customize the widget

### Colors, fonts, and styling

The widget pulls its colors, fonts, button shapes, and copy from **Design Studio** in Fanfare rather than your Shopify theme settings, keeping every drop consistent across your store. If you don't specify a custom brand font, the widget inherits your Shopify theme's font automatically. See [Set your brand](https://docs.fanfare.io/guide/create/brand.md).

### Theme editor block settings

The widget block exposes two settings in the Shopify theme editor:

| Setting | What it does |
| - | - |
| **Product** | Selects which product's experience to display. Defaults to the current product page; pick another product if you're featuring a drop elsewhere. |
| **Product Form Selector** | The CSS selector for your theme's buy-button container, which the widget hides while a product is in an experience. Defaults to `.product-form`, which matches standard Shopify themes. |

### Preview before launch

In the theme editor, the widget includes a preview panel with a **Hide product form** toggle. Flip it on to verify your buy buttons hide cleanly before your drop goes live.

## Troubleshooting

> [accordion] My buy buttons still appear on a product in an experience
>
> Your theme's buy-button container doesn't match the default `.product-form` selector. Ask your theme developer or provider for the CSS selector wrapping your buy buttons, then paste it into the widget's **Product Form Selector** setting in the theme editor. To hide multiple elements, separate selectors with commas. Use the **Hide product form** toggle in the preview panel to confirm it works before launch.

> [accordion] Storefront setup shows 'Couldn't check'
>
> Fanfare couldn't read that setting from Shopify. Select **Check again**. If the product widget stays at **Couldn't check**, Fanfare may be missing permission to read your store's themes (which doesn't trigger an automatic prompt on app open). Verify in the theme editor that the block is placed on your product template, and contact Fanfare support to restore theme read permission.

> [accordion] The widget is on my theme, but nothing shows on the product page
>
> That's expected if the product isn't attached to an experience yet. Once you add the product to an experience, the widget appears regardless of the experience's status. If it still doesn't show, check whether a `"Shopify gating could not be updated"` warning appeared when you saved—see [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

> [accordion] Shoppers are blocked at checkout
>
> Checkout protection blocks protected products added to the cart outside the widget—for example, through direct cart links or quick-add buttons on collection pages. Direct shoppers to the product page so they can enter through the widget.

## Related

> [card] [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md)
>
> Learn how the checkout rule works, how long protection lasts, and how to test it.

> [card] [Your first drop on Shopify](https://docs.fanfare.io/guide/start/your-first-drop-on-shopify.md)
>
> Follow the full walkthrough from install to post-drop review.

> [card] [Set your brand](https://docs.fanfare.io/guide/create/brand.md)
>
> Customize widget colors, fonts, and button styling in Design Studio.

> [card] [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md)
>
> Import products from your Shopify catalog and keep inventory synced.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.