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

# Add products

> Create products manually or with Autofill, then configure their variants, prices, and images before attaching them to a drop.

A product is anything your drop sells or gives access to. You add it to Fanfare once—along with its variants, prices, and images—and attach it to as many experiences as you like.

Before you create your first product, decide on **Stock management** (who tracks how many units exist). It's the one setting on a product you can't change later—read [Manage stock](https://docs.fanfare.io/guide/create/stock.md) before saving.

## Before you start

* Decide who keeps the stock count for this product. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md#choose-who-keeps-the-stock-count).
* If your product comes in sizes, colors, or other options, [set up those options](#set-up-variant-options) under **Settings → Variant Options** first.
* Have your product images ready as JPEG, PNG, GIF, or WebP files (up to 50 MB each).

## Create a product

**1. Enter product details and choose stock management**

Open **Products** and select **Create Product**. On **Product Details**, enter a unique **Name**. **Description**, **Product URL**, and **Handle** are optional (the handle fills in automatically from the name until you edit it).

Under **Stock management**, choose **Fanfare-managed** (default) or **Not managed**. **Shopify-managed** is only assigned to products imported from Shopify. If your organization uses external checkout, every product is created as **Not managed**. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md) to compare options.

> [!WARNING]
>
> **Stock management** locks permanently once you create the product. You can't switch a **Not managed** product to **Fanfare-managed** later, which means Fanfare won't track inventory or stop a drop from overselling it. If you choose the wrong option, you'll need to recreate the product—and because product names must be unique, [delete the old product](#delete-a-product) first or use a different name.

![The Product Details step of the Create Product form, with Not managed selected under Stock management and a notice saying Not managed is permanent for this product.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/products-create-stock-management.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=812e62f431ae8787dbb6dd91e7910bc7)

Choosing Not managed displays a reminder that this setting can't be changed later.

**2. Upload product images (optional)**

Select **Next** to open **Media**, then drag in your images or choose files from your computer.

**3. Add variants and inventory**

Select **Next** to open **Variants & Inventory**. Choose **Simple product** for a single price and SKU, or **Product with variants** for sizes, colors, or other options:

* **Simple product:** Enter the **SKU**, **Price**, and either **Opening stock** (Fanfare-managed) or **Quantity** and **Inventory policy** (Not managed). On a Not managed product, **Quantity** and **Inventory policy** are for reference only and don't cap sales—see [Manage stock](https://docs.fanfare.io/guide/create/stock.md).
* **Product with variants:** Follow [Add variants](#add-variants) below.

Select **Create** to save your product and return to the **Products** list.

> [!NOTE]
>
> The wizard saves your draft in your current browser tab while you work. Refreshing the page clears any images added on **Media**, and closing the tab discards the draft.

## Autofill from a store link

If your product already lives on an online store, Fanfare can pull in its name, description, images, and variants so you don't have to enter them by hand.

> [!NOTE]
>
> Available on Growth and above. On Starter, you can enter a link, but **Autofill** stays locked until you upgrade.

1. On **Product Details**, paste the full URL (starting with `https://`) into **Product page link**.
2. Select **Autofill**. If you've already typed details into the form, select **Replace and autofill** to confirm overwriting them.
3. Wait 15–40 seconds while Fanfare reads the page.
4. Review any items listed under **Needs your decision** and resolve them.
5. Check every step of the wizard, choose **Stock management**, and select **Create**. Nothing is saved until you select **Create**.

| Limit | Value |
| - | - |
| Autofills per organization | 25 per day, up to 3 per minute |
| Images imported | Up to 12 |
| Variants imported | Up to 100 (keeps the first 100 found) |
| Options inferred from page text | Up to 3 |

Common **Needs your decision** prompts include:

* **Currency mismatch:** The store uses a different currency than your organization, so prices were left blank—enter each price yourself.
* **Locked variant option:** One of your organization's options is locked, so unrecognized values and their variants were skipped.
* **Duplicate name:** A product with that name already exists—rename this one before saving.
* **Unconfirmed variants:** Variants were inferred from page text or couldn't be confirmed (falling back to a simple product)—double-check each variant and price on the final step.

> [!NOTE]
>
> Autofill immediately adds any unrecognized options—and any new values for unlocked options—to **Settings → Variant Options**. They remain there even if you cancel the wizard.

If Autofill fails or is temporarily unavailable, you can always fill out the form manually.

## Add variants

A variant is a buyable version of your product—such as Medium in Black—with its own SKU and price.

### Set up variant options

Options like Size or Color, along with their values (such as M or Black), are shared across every product in your organization under **Settings → Variant Options**.

1. Select **Add Option**, enter a **Name**, and select **Create**—or select **Use Template** to apply a preset category like Clothing or Footwear.
2. Add values to each option. You can edit or reorder values anytime, and delete a value as long as no product variant uses it.
3. Drag options into the order you want them to appear.

You can't delete an option while any product uses it.

> [!TIP]
>
> Set up your variant options before starting the Create Product wizard. Following **Create option** from the wizard's option picker navigates away and clears any images you uploaded on **Media**.

### Add variants to a product

On **Variants & Inventory** in the wizard, or in the **Variants** card on an existing product:

1. On an existing product that already has variants, select **Edit options** first. Under **Options**, choose the options this product uses, then select or type values for each (use **Add all** to select every value). Typing a new value adds it to your organization's options right away. On an existing product, selected values aren't saved until you create variants that use them.
2. Check **SKU format** and its **Preview**. Make sure the format includes every selected option so Fanfare can generate unique SKUs.
3. Select **Create all N** to generate every combination at once, or **Create your first variant** (then **Add Variant**) to add them one by one.
4. Enter a **Price** and a unique, case-sensitive **SKU** for every variant.

On an existing product, **Create N missing** adds any combinations that don't exist yet. Confirm to save them immediately—each starts with the first variant's price (or `0.00`) and `0` stock, so review their prices and stock afterward.

Once a variant uses an option or value, that option or value can't be removed from the product.

### Pricing rules

With Fanfare checkout, every price must be chargeable in your organization's currency:

* Up to two decimal places (or whole amounts for zero-decimal currencies like JPY and HUF).
* At least your currency's minimum charge (for example, \$0.50 USD, €0.50 EUR, or £0.30 GBP).
* `0` is always allowed for free items.

External checkout doesn't enforce these minimums.

## Add and arrange images

* **In the wizard:** Add images on **Media**. Any images imported by Autofill appear here too.
* **On an existing product:** Select the **+** tile below the gallery to upload files from your computer. Uploads save right away.
* **Reorder:** Drag thumbnails into the order you want. The first image is your product's main image.
* **Remove:** Hover over the large preview and select the trash icon in the corner.

> [!NOTE]
>
> Removing an image from an existing product deletes it immediately with no confirmation and no undo.

## Edit a product

Open any product from **Products**. You can rename it inline by clicking the title at the top (which saves right away), or update **Name**, **Description**, **Product URL**, and **Handle** in the form and save from the action bar.

> [!WARNING]
>
> Price and SKU updates apply immediately to every experience offering the product, including live drops. If the product is in a pre-authorized drop that holds a single fixed amount, Fanfare blocks price changes that don't match that amount until the drop ends and all payment windows close (or the experience is deleted).

With Fanfare checkout, shoppers pay the price active when they submit payment—so a customer inside a payment window who hasn't submitted yet pays the updated price. Auction winners always pay their winning bid.

## Field reference

| Setting | What it does | Default | Editable while live? |
| - | - | - | - |
| **Name** | Unique product name across your organization. | Required | Yes |
| **Description** | Product copy shown to shoppers. | Empty | Yes |
| **Product URL** | Link to the product on your store. Used in winner messages when an experience has no [hosted page](https://docs.fanfare.io/guide/create/hosted-page.md). | Empty | Yes |
| **Handle** | URL-friendly slug for the product. | Auto-generated from name | Yes |
| **Stock management** | Who tracks inventory. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md). | **Fanfare-managed** (Fanfare checkout); **Not managed** (external checkout) | No—locked at creation |
| **SKU** | Unique variant identifier within the product (case-sensitive). | Required | Yes |
| **Price** | Amount a customer pays for the variant. | Required | Yes (reaches live drops), unless locked by a pre-authorized drop |
| **Opening stock** | Starting inventory for **Fanfare-managed** variants. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md). | `0` | No—use **Adjust stock** instead |
| **Quantity** | Reference count for **Not managed** variants. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md). | `0` | Yes |
| **Inventory policy** | Reference policy for **Not managed** variants: **Untracked (always available)**, **Deny when out of stock**, or **Continue selling (allow oversell)**. | **Deny when out of stock** | Yes |

## Delete a product

Select **Delete** on the product page, or open a product's menu on the **Products** list and select **Delete** (**Delete product** in card view).

You can't delete a product while any active, upcoming, or draft experience offers it—including while a sequence is finishing up (customers still in line or in a payment window) or holding counted stock. Fanfare lists the blocking experiences so you can end them, delete them, or remove the product from them first.

> [!NOTE]
>
> Deleting a product can't be undone. You can delete individual variants only on **Not managed** products, and you can't delete a product's last remaining variant.

## On Shopify

In the Shopify app, products come directly from your Shopify catalog:

* There's no **Create Product** button. Instead, pick products through Shopify's product picker wherever Fanfare asks for one (whole products only, up to 20 at a time).
* A Shopify product's name, description, URL, handle, and variants are read-only in Fanfare. Edit them in Shopify admin, then select **Sync from Shopify** on the product page.
* **Sync from Shopify** replaces **Delete**, and the **Variants** card isn't shown.

For importing, re-syncing, images, **Source missing**, and sync errors, see [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md). To launch a drop directly from a product in Shopify admin, see [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md).

## Troubleshooting

> [accordion] I can't delete a product
>
> An active, upcoming, or draft experience still includes it, or a sequence is still finishing checkouts or holding stock. Remove the product from those experiences—or end or delete them—then try again. See [Delete a product](#delete-a-product).

> [accordion] Autofill left my prices blank
>
> The store either uses a different currency than your organization or didn't list an unambiguous price for each variant. Enter each variant's price before selecting **Create**.

> [accordion] Create all N isn't generating variants
>
> Your **SKU format** is missing one of the options you selected. Open **Edit options**, include every selected option in the format, and try again.

> [accordion] I can't delete an option in Variant Options
>
> The error names the products still using it. Open each product, select **Edit options**, and remove the option under **Options**. If a product already has variants using that option, you can't clear it—you'll need to [delete that product](#delete-a-product) to free the option.

## Related

> [card] [Manage stock](https://docs.fanfare.io/guide/create/stock.md)
>
> Choose who keeps the stock count and record stock changes.

> [card] [Create an experience](https://docs.fanfare.io/guide/create/experiences.md)
>
> Attach your product to a drop.

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

> [card] [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md)
>
> How Shopify products sync into the Fanfare app.


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