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

# Your first drop on Shopify

> Install the Fanfare app, set up your Shopify storefront, and launch your first protected drop.

This walkthrough takes you from installing the Fanfare app in Shopify to reviewing results after your first drop. There's no separate Fanfare sign-up—installing the app creates your Fanfare organization automatically, and customers complete checkout right in Shopify.

## Before you start

* Your store uses a currency supported by Fanfare. See [Install and choose a plan](https://docs.fanfare.io/guide/shopify/install-and-plans.md).
* Your Shopify staff account has permission to install apps, update checkout settings, and edit your published theme.

## Step 1: Install the app and choose a plan

Install the Fanfare app from Shopify and approve the requested permissions. Fanfare creates your organization automatically using your store's currency, then opens Shopify's plan page so you can choose a plan (including the free **Starter** plan). See [Install and choose a plan](https://docs.fanfare.io/guide/shopify/install-and-plans.md).

> [!NOTE]
>
> Any Shopify staff member who can open the Fanfare app has full admin permissions inside Fanfare, including managing API keys and email sender settings. Review your Shopify staff permissions accordingly—see [Who can use the app](https://docs.fanfare.io/guide/shopify/overview.md#who-can-use-the-app).

## Step 2: Set up your storefront

Before running your first drop, complete the two setup steps under **Settings → Storefront setup** (also tracked by the setup checklist on **Home**):

1. **Confirm checkout protection is on.** Fanfare usually enables checkout protection automatically during installation. Check that the **Checkout protection** card shows **On**.
2. **Add the product widget to your theme.** Select **Add to product page** to open the Shopify theme editor with the Fanfare Product Widget ready to place. Drag it to where your buy buttons appear, then save. If you use multiple product templates for drops, add the widget to each one.

Both steps are required before your drop goes live: checkout protection blocks direct cart links and normal checkouts for protected products, while the widget gives customers a way to enter your drop. See [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md) for full theme setup instructions.

## Step 3: Create an experience for your product

On Shopify, you don't need to recreate products in Fanfare—you pick them straight from your Shopify catalog while setting up the experience.

1. Open **Experiences** and select **Create Experience**. You can also start directly from a product page in Shopify admin using **Create Fanfare experience** (or **Start a Fanfare experience** in the **Fanfare experiences** block) to pre-attach that product. See [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md).

2. Choose a drop type: **Queue**, **Draw**, **Timed Release**, or **Auction**. For a first drop, a [queue](https://docs.fanfare.io/guide/create/queue.md) or [timed release](https://docs.fanfare.io/guide/create/timed-release.md) is the quickest to set up.
   * **Auction** is available when your store's checkout supports charging the winning bid. See [Auctions on Shopify](https://docs.fanfare.io/guide/shopify/checkout-protection.md#auctions-on-shopify).
   * **Appointment** is not available in the Shopify app.

3. On **Configure Experience**, pick up to 10 products from your Shopify catalog. Fanfare imports each product with all of its variants. Product details stay read-only in Fanfare—if you edit a product in Shopify later, use **Sync from Shopify** on the product's Fanfare page to pull in changes right away. See [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md).

   > [!WARNING]
   >
   > Checkout protection starts as soon as you add a product to an experience—even before the drop opens—and stays active after the drop ends, including if you deactivate it. Customers won't be able to buy the product normally until you remove it from the experience or delete the experience. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

4. Enter an **Experience Name**, select your **Time Zone**, and set your **Opens At** and **Closes At** times.

   > [!NOTE]
   >
   > **Opens At** defaults to the next minute, and drops open automatically at their scheduled time. Update **Opens At** before finishing so your drop doesn't go live immediately. See [Create an experience](https://docs.fanfare.io/guide/create/experiences.md).

5. On **Stock**, set how many units this drop can sell. Shopify remains the source of truth for inventory counts on imported products. See [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md).

6. Complete the remaining configuration steps for your drop type. Because customers pay in Shopify checkout, there's no Fanfare payment collection to configure.

7. On **Access**, choose who can enter, then review your settings and select **Create experience**.

## Step 4: Match your store's look

The product widget takes its styling from Fanfare rather than your Shopify theme settings, keeping every drop consistent across your store.

* Customize your brand colors and fonts in **Design Studio** on any plan (widget design templates require Growth or above). If you don't set a custom font, the widget inherits your Shopify theme's font automatically. See [Set your brand](https://docs.fanfare.io/guide/create/brand.md) and [Templates and widget designs](https://docs.fanfare.io/guide/create/templates.md).
* Preview how the widget replaces your buy buttons directly in the Shopify theme editor. See [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md).

> [!NOTE]
>
> Run Shopify drops on your store's product page rather than a Fanfare-hosted page—hosted pages can't hand customers off to Shopify checkout.

## Step 5: Announce your drop

Save a business postal address in **Settings → Email Sender** first (required before scheduling email announcements), then schedule your emails from the experience's **Marketing Hub**. See [Sender identity and sending domain](https://docs.fanfare.io/guide/create/email-sender.md) and [Announcements](https://docs.fanfare.io/guide/create/announcements.md).

Test emails are sent to your Shopify staff account's email address once Shopify has verified it.

## Step 6: Verify checkout protection

Before doors open, run a quick check to confirm your product is protected:

1. Open **Settings → Storefront setup** and verify **Checkout protection** shows **On**.
2. Confirm you didn't see a gating sync warning when saving the experience (if you did, see [When protection did not update](https://docs.fanfare.io/guide/shopify/checkout-protection.md#when-protection-did-not-update)).
3. Optionally, try checking out the product through a direct cart link without going through the widget to confirm Shopify blocks the checkout.

See [Check that a drop is protected](https://docs.fanfare.io/guide/shopify/checkout-protection.md#check-that-a-drop-is-protected) for details.

## Step 7: Watch your drop live

Follow traffic, entries, and sales in real time from the Fanfare app—see [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md) and [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

Paid orders from your drop sync automatically to **Orders** in Fanfare. If you refund or cancel an order in Shopify, handle that in Shopify—those changes don't sync back to Fanfare. See [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md).

## Step 8: Wrap up after the drop

Review how your drop performed in [Read your results](https://docs.fanfare.io/guide/learn/performance.md).

If you plan to sell the product normally again after the drop, remove it from the experience or delete the experience so checkout protection is lifted. Keep in mind that you can't remove a product while the experience holds allocated units, and deleting an experience waits until active checkout holds finish winding down. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md) and [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

## Related

> [card] [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md)
>
> Enable checkout protection and add the product widget to your theme.

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

> [card] [Fanfare in Shopify](https://docs.fanfare.io/guide/shopify/overview.md)
>
> How the Shopify app compares to the standalone Fanfare admin.

> [card] [Your first drop](https://docs.fanfare.io/guide/start/your-first-drop.md)
>
> The standalone walkthrough for admin.fanfare.io.


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