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

# Install and choose a plan

> Install the Fanfare app from Shopify, approve your plan, understand usage billing, and resolve access issues.

You install and pay for Fanfare directly through Shopify—no separate Fanfare sign-up or login required. Installing the app creates your Fanfare organization automatically, then prompts you to approve a plan on Shopify's plan page before opening the app.

This guide covers installation, choosing or changing plans, how Fanfare's per-order fees appear on your Shopify bill, and how to handle permissions or access blocks.

## Before you start

* Your Shopify staff account has permission to install apps and approve app permissions.
* Your store uses a currency supported by Fanfare.

Fanfare supports every currency Shopify offers except USD Coin (USDC), Venezuelan digital bolívar (VED), Kiribati dollar (KID), and withdrawn or placeholder codes (VEF, BYR, LTL, LVL, XXX).

> [!WARNING]
>
> If your store uses an unsupported currency, the entire app displays a single notice: `"Fanfare isn't available for stores priced in … yet. Change your store's currency to use Fanfare."` (with your currency code filled in), and no other pages—including **Billing**—are accessible. Update your store's currency in Shopify and reopen Fanfare; the currency check runs automatically on every page load.

## Install the app

**1. Install from Shopify**

Install the Fanfare app from Shopify and approve the requested permissions.

**2. Automatic organization setup**

Shopify opens Fanfare and automatically creates your organization using your store's currency. There's no step to link an existing Fanfare organization.

**3. Continue to plan selection**

Because your store doesn't have a plan yet, Fanfare sends you straight to Shopify's plan page.

## Choose your plan

Until Shopify confirms a plan for your store, opening any Fanfare screen redirects you to Shopify's plan page—or to **Confirming your plan** if you've just approved one. Only **Billing** and **Usage** remain accessible in the meantime.

> [!WARNING]
>
> Every store must approve a plan on Shopify's plan page—including the free **Starter** plan—before using Fanfare (unless your store is comped or on an older Fanfare subscription). You won't be able to open **Home**, **Experiences**, or other screens until you approve a plan.

**1. Pick a plan**

On Shopify's plan page, choose **Starter**, **Growth**, or **Pro**. **Enterprise** appears only if Fanfare has configured a custom plan for your store.

**2. Approve in Shopify**

Confirm your selection in Shopify.

**3. Return to Fanfare**

Shopify redirects you back to Fanfare. If your plan confirms immediately, the app opens; otherwise you'll see **Confirming your plan** until confirmation completes.

To compare plan features, take rates, and downgrade rules, see [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md).

### While Fanfare confirms your plan

Shopify can take a moment to notify Fanfare after you approve a plan. While you wait, **Confirming your plan** displays `"Fanfare is confirming the plan you approved. This usually takes a few seconds, and can take a few minutes."` and rechecks automatically—no need to refresh.

* **If confirmation takes more than \~7 minutes:** The page stops checking and displays `"Fanfare is still confirming your plan, which is taking longer than usual. Please contact Fanfare support so we can finish setting it up."` If you opened the page from inside Fanfare rather than directly from Shopify, you'll also see **Try again**.
* **If Fanfare can't identify the approved plan:** The page lets you know and offers **Continue to Fanfare** to return to the app. If either button loops you back to the confirmation screen, wait a few minutes and retry, or contact Fanfare support.

### Next: finish storefront setup

Once the app opens, a short setup tour guides you through the two storefront steps required before your first drop: confirming **checkout protection** is on (usually enabled automatically at install) and adding the **product widget** to your theme.

Keep in mind that as soon as you add a product to an experience, checkout protection blocks ordinary checkouts even if the widget isn't on your theme yet—and without the widget, shoppers can't enter your drop from the product page. Check both statuses under **Settings → Storefront setup** (see [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md)), or follow the full walkthrough in [Your first drop on Shopify](https://docs.fanfare.io/guide/start/your-first-drop-on-shopify.md).

## Change your plan later

**1. Open Billing**

In Shopify admin, open the Fanfare menu and select **Billing**.

**2. Switch on Shopify's plan page**

Fanfare opens Shopify's plan page automatically. If your browser blocks the redirect, select **Open it here if it didn't open.**

**3. Approve your new plan**

Choose and approve your new plan in Shopify. You'll return directly to Fanfare (or briefly see **Confirming your plan** while Shopify confirms the change).

All subscription management—plan cards, invoices, payment methods, and cancellation—lives in Shopify. If anyone on your team opens the standalone Fanfare admin, its billing page displays `"Billed through Shopify"` with disabled **Manage in Shopify** buttons. See [Billing and usage](https://docs.fanfare.io/guide/account/billing.md).

If your subscription is canceled or lapses, opening Fanfare sends you back to Shopify's plan page (only **Billing** and **Usage** stay accessible) until you approve a plan again, including **Starter**. Live drops continue serving shoppers in the background—see [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md).

### Stores on an older Fanfare subscription

If your store subscribed before Fanfare's current Shopify plans launched, the app lets you in on your existing subscription and displays a banner showing your active end date (in UTC) with the note `"The Fanfare plan you choose in Shopify starts when it ends."` (or `"until its current billing period ends"` if Shopify doesn't provide an end date). Any new Shopify plan you select begins once your legacy subscription ends.

### Comped stores

If Fanfare provides your store's plan at no charge, opening **Billing** shows `"Your plan is comped: Fanfare provides it at no charge, so there is no plan to choose or pay for here."` and never redirects you to Shopify's plan page.

## Fanfare's fees on Shopify checkout orders

When customers purchase through a Fanfare experience and pay in Shopify checkout, Fanfare's per-order take-rate fee is billed as a Shopify usage charge in US dollars. Fees are calculated in your store's currency and converted to USD using the daily UTC reference rate for the date the order was paid.

Open **Usage** in the Fanfare menu to review fees recorded in each Shopify billing cycle, where each fee is charged, and any fee that wasn't billed and why. See [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) and [Payments and fees](https://docs.fanfare.io/guide/account/payments.md) for details.

## Approve new permissions

Occasionally Fanfare needs an additional Shopify permission your store hasn't granted yet:

* **Core store connection permissions:** If a required permission is missing, opening Fanfare prompts you to approve it. Until approved, syncing products, importing orders, and pushing orders to Shopify will ask you to reconnect your store.
* **Theme and location permissions:** Fanfare requests permission to read your store's themes and inventory locations during install. If either is missing later, the app won't prompt you on open and most features keep working—however, **Settings → Storefront setup** shows **Couldn't check** for the product widget (missing themes permission), or Shopify inventory counts stop updating (missing locations permission).

To review who on your Shopify team can open Fanfare and what they can change, see [Who can use the app](https://docs.fanfare.io/guide/shopify/overview.md#who-can-use-the-app).

## Uninstall the app

Uninstall Fanfare from Shopify's app settings like any other app:

* Your Fanfare organization immediately moves to a canceled **Starter** state.
* Any usage fees accrued in your current Shopify billing cycle are billed when that cycle closes (unless the billing window ends first). Fees after uninstall aren't billed and are marked accordingly in **Usage**.

If you reinstall Fanfare later, you'll approve a plan on Shopify's plan page again before using the app.

## Troubleshooting

> [accordion] The app says Fanfare isn't available for my store's currency
>
> Fanfare doesn't support pricing in your store's current currency, so the notice replaces all app screens. Change your store's currency in Shopify settings and reopen Fanfare—the check runs automatically on every load.

> [accordion] I'm stuck on 'Confirming your plan'
>
> Leave the page open—it checks automatically for about 7 minutes and opens Fanfare as soon as Shopify confirms your plan. If it prompts you to contact Fanfare support, reach out so we can complete setup. If you see **Try again** or **Continue to Fanfare**, select it; if it brings you back to the confirmation screen, wait a few minutes before retrying or contact support.

> [accordion] Shopify's plan page didn't open
>
> Selecting **Billing** redirects to Shopify's plan page. If your browser blocked the redirect, select **Open it here if it didn't open.** on the fallback screen.

> [accordion] I'm being asked to approve permissions again
>
> Fanfare requires an updated Shopify permission for its store connection. Approve the prompt to restore access. See [Approve new permissions](#approve-new-permissions) for what pauses while a permission is missing.

## 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] [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md)
>
> Compare monthly pricing, take rates, and included features.

> [card] [Billing and usage](https://docs.fanfare.io/guide/account/billing.md)
>
> Track usage fees and billing cycles on the Usage page.

> [card] [Fanfare in Shopify](https://docs.fanfare.io/guide/shopify/overview.md)
>
> See what's the same and what differs from the standalone Fanfare admin.


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