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

# Products from Shopify

> Import products from your Shopify catalog, understand read-only fields, and keep product details and inventory synced.

In the Shopify app, your Shopify catalog stays the source of truth for your products. Rather than recreating products in Fanfare, you pick them directly from Shopify when setting up an experience—Fanfare imports each product with its variants and images, and pulls in Shopify's inventory counts within a couple of minutes. Whenever you edit a product in Shopify, Fanfare keeps its copy in sync.

## Before you start

* The Fanfare app is installed on your store. See [Install and choose a plan](https://docs.fanfare.io/guide/shopify/install-and-plans.md).
* The products and variants you plan to drop already exist in Shopify admin.

## Import products from Shopify

There's no manual product creation form in the Shopify app—products enter Fanfare when you select them through Shopify's product picker.

**1. Open the product picker**

Start anywhere Fanfare asks for a product, such as when creating an experience.

**2. Choose your products and confirm**

Select the products you want in Shopify's product picker and confirm. Fanfare immediately imports each selected product along with all of its variants.

Imported products stay in **Products** as soon as you confirm the picker, even if you leave the experience unsaved.

Keep these picker rules in mind:

* **Whole products only:** You can't pick individual variants—Fanfare imports every variant on the selected product.
* **Selection limits:** An experience holds up to 10 products, so the picker caps your selection to the remaining open slots. When picking products for a sequence, you can choose up to 20 at a time.
* **Unpublished products work:** You can select draft or unpublished products to prepare a drop before publishing them to a sales channel.

> [!NOTE]
>
> Fanfare only stores products you've picked. New products you create in Shopify aren't imported automatically—just pick them when you're ready to use them in a drop.

You can also start directly from a Shopify product page using **Create Fanfare experience** or **Start a Fanfare experience** in the **Fanfare experiences** block, which imports and attaches the product automatically. See [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md).

## Review imported products

Open **Products** in Fanfare to see every product imported from Shopify and check which experiences use it. In the list view, the **Stock** column shows `—` for Shopify products; open any product to view its synced Shopify inventory count.

## What stays managed in Shopify

Because Shopify is the source of truth, imported products are read-only in Fanfare. Opening one displays a **Managed by Shopify** badge along with the experiences using it.

| Product field | In Fanfare | Where to edit |
| - | - | - |
| Product name | Read-only plain text | Shopify admin |
| **Name**, **Description**, **Product URL**, **Handle** | Read-only (marked **Managed by Shopify**) | Shopify admin |
| Variants | Read-only; variants can't be added, edited, or removed | Shopify admin |
| Stock | Synced from Shopify as **Total Stock** (no **Adjust stock** option while your checkout processor is **External**, the Shopify default) | Shopify admin |
| Images | Copied from Shopify; can't be added, removed, or reordered in Fanfare (see [Images](#images)) | Shopify admin |
| Deleting the product | No **Delete** action in the list or product view | Not applicable |

If a product was imported while your organization used Fanfare checkout instead of **External** checkout, its stock stays Fanfare-managed and won't follow Shopify's count. See [Fanfare in Shopify](https://docs.fanfare.io/guide/shopify/overview.md) and [Manage stock](https://docs.fanfare.io/guide/create/stock.md).

To update any field, edit the product in Shopify admin. Fanfare pulls in most updates automatically (see [Keep products up to date](#keep-products-up-to-date)), or you can select **Sync from Shopify** to refresh immediately.

> [!WARNING]
>
> Don't remove a variant in Shopify while a sequence is still counting stock for it. Even though the sync succeeds, Fanfare retains that variant and can keep offering it to shoppers until no sequence counts stock for it—which includes active customer payment windows after a drop closes. Wait until every drop offering that variant has fully ended and the last payment window has closed, then remove the variant in Shopify and select **Sync from Shopify**.

If you delete a product in Shopify, Fanfare keeps its record with a **Source missing** badge. You won't be able to add it to new experiences or sequences (`"This product is no longer available from Shopify."`), though Fanfare doesn't remove it from experiences that already include it.

## Keep products up to date

### Automatic updates

* **Product details:** Edits you make in Shopify sync automatically to products Fanfare already holds.
* **Inventory counts:** Fanfare refreshes Shopify stock roughly every two minutes, so changes take a moment to appear.
* **Eligible locations:** Counts include only active Shopify locations that fulfill online orders.
* **Uncountable variants:** Fanfare can't read inventory for variants untracked in Shopify or stocked across more than 10 locations. Those variants add 0 to **Total Stock** (and the product shows **Untracked** if no other variant has readable stock).

For variants Fanfare can't count, sequences with stock limits start at 0—you'll need to set a manual allocation or sell without a limit for that variant to be available. See [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md) and [Stock](https://docs.fanfare.io/concepts/stock.md).

### Sync a product immediately

Run a manual sync after editing a product in Shopify when you want changes in Fanfare right away, or if anything looks out of date:

**1. Open the product**

Go to **Products** in Fanfare and select the product.

**2. Run Sync from Shopify**

Select **Sync from Shopify** (the button reads **Syncing from Shopify…** while running).

**3. Verify confirmation**

When `"Product synced from Shopify"` appears, your product details are updated and fresh stock counts have been requested.

### Sync error messages

If a sync fails—either manually or while picking products in an experience—Fanfare displays one of these messages. (Adding products to a sequence shows a generic `"Failed to add products"` message instead.)

| Message | What it means and how to fix it |
| - | - |
| `"This product could not be found in Shopify."` | The product no longer exists in Shopify. Verify it in Shopify admin. |
| `"Remove the restricted product option before syncing again."` | One of the product's Shopify option values isn't allowed by your organization's option settings. |
| `"This Shopify product is already linked to a different Fanfare product."` | Another Fanfare product record is already mapped to this Shopify product or one of its variants. |
| `"Reconnect Shopify before syncing this product."` | Fanfare lost its connection to your store. Reconnect Shopify and try again. |
| `"Reconnect Shopify to restore the organization mapping."` | Fanfare lost the link between your store and organization. Reconnect Shopify. |
| `"Shopify did not return the complete product. Try syncing again."` | Shopify returned only part of the product. Select **Sync from Shopify** again. |
| `"The Shopify product could not be synced. Try again."` | A temporary sync error occurred. Select **Sync from Shopify** again. |

## Images

Fanfare copies product images from Shopify in the background. Hosted pages only display an image once its copy finishes:

* **Copying…:** The image is currently copying from Shopify and will appear on hosted pages once ready.
* **Couldn't copy:** The copy failed, so hosted pages can't show it yet. Select **Try again** on the image to retry.

## Products eligible for Shopify checkout

Experiences using Shopify checkout can sell only active products and variants synced from Shopify. If any item doesn't qualify, Fanfare flags it with `"Shopify checkout can only sell products and variants synced from Shopify. Remove any that aren't."` See [Create an experience](https://docs.fanfare.io/guide/create/experiences.md).

## Related

> [card] [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md)
>
> Start an experience directly from a Shopify product page.

> [card] [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md)
>
> Allocate inventory across an experience and its sequences.

> [card] [Stock](https://docs.fanfare.io/concepts/stock.md)
>
> Understand inventory ownership and how stock behaves during drops.

> [card] [Set up a draw](https://docs.fanfare.io/guide/create/draw.md)
>
> Learn how Shopify stock counts set a draw's initial winner count.

> [card] [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md)
>
> See how Shopify blocks unauthorized checkouts for drop products.

> [card] [Add products](https://docs.fanfare.io/guide/create/products.md)
>
> Manage standalone Fanfare products and organization-wide variant options.


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