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

# Allocate stock to a drop

> Reserve inventory for an experience, split units across its sequences, and understand when allocations lock before a drop opens.

Before a drop opens, you decide two things: how many units of each size the experience can sell, and how those units split across its sequences. Each sequence sells only its own share.

You set starting counts when creating the experience, and you can raise, lower, or rebalance them freely until stock counting starts—about 10 minutes before a sequence opens. After that, sequence counts can only move up in the grid.

## Before you start

* **Two-level pools for Fanfare-managed products:** Your experience reserves units from the product's **Available** stock, and each sequence draws its share from the experience. Any experience units not given to a sequence stay **Unassigned**. See [Stock](https://docs.fanfare.io/concepts/stock.md).
* **Other stock modes:** **Not managed** products have no experience-level inventory pool—each sequence's number is the only cap. **Shopify-managed** products work differently (see [On Shopify](#on-shopify)). Compare all modes in [Manage stock](https://docs.fanfare.io/guide/create/stock.md).
* **No mixing managed modes:** An experience can't combine **Fanfare-managed** and **Shopify-managed** products, though **Not managed** products can sit alongside either.
* **Add a distribution first:** A sequence has no stock rows until you add its first distribution.
* **External checkout:** Because an external checkout doesn't report sales back to Fanfare, the wizard displays **Sales aren't counted** and your numbers cap concurrent passes held at once rather than actual units sold.

## Set units when you create the experience

The **Stock** step appears in **Experiences → Create Experience** whenever you select at least one product for a non-appointment drop.

1. Enter the units for each size. **Fanfare-managed** sizes show **Supply**, **Allocated**, **Available**, and **Available after** alongside the input.
2. For multi-size products, select **Split a total across sizes** to distribute inventory automatically: enter **Total to split**, select **Preview**, and select **Apply**. Fanfare-managed sizes never exceed available stock—if there's a shortfall, Fanfare lets you redistribute it across sizes with room left.
3. For non-Fanfare-managed products, you can select **No limit** instead of a number (**Fanfare-managed** sizes always require a number).
4. Review the **Total** at the bottom and select **Next**.

![The Stock step of the create-experience wizard with the split helper open: 60 entered and previewed as 46 placed and 14 short, above a table listing each size of a Fanfare-managed product with its supply, allocated and available stock, a units field and the available stock after.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/stock-allocation-wizard-step.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=c1a8cf0d982faafe7b950fe75dca98c1)

Fanfare-managed sizes show available stock inline, and the split helper never allocates more than you have.

If you request more units than a **Fanfare-managed** size has available, Fanfare blocks **Next** and shows which experiences hold that stock—letting you cap at available stock, reduce an upcoming experience, or record a receipt on the product.

Leaving a size at `0` marks it **Not on sale here**—it opens sold out and customers won't be able to buy it.

How unit numbers behave depends on your drop format:

| Distribution | How unit limits work |
| - | - |
| **Queue** | Caps units sold per size. Admission speed is controlled by **Admit rate** on **Queue Configuration** (the admin has no setting to cap queue length). |
| **Draw** | Caps units sold per size. The first sequence receives all units, and the winner count follows the total (unless a size is set to **No limit**; see [Set up a draw](https://docs.fanfare.io/guide/create/draw.md)). |
| **Timed release** | Setting a number on any size disables automatic entry (shoppers click Enter to join). Leaving every size at **No limit** keeps automatic entry available. |
| **Dutch auction** | Every size requires a number. The auction sells the total across all sizes. |
| **English auction** | Offers 1 unit of each size with 1 winner taking 1 unit—nothing to enter. |

If you haven't picked Dutch or English yet, the column appears as **Units (if Dutch)**. See [Set up an auction](https://docs.fanfare.io/guide/create/auction.md) to compare auction types.

Finishing the wizard assigns every unit you entered directly to the experience's first sequence, leaving `0` **Unassigned**.

## Change the experience's units later

1. Open your experience's **Overview**. For **Fanfare-managed** products, the **Stock** card shows each size's **Allocated** count, each sequence's share, **Unassigned**, **Sold**, and either **Available** (before launch) or **In checkout** (while live). Other products show each size's **Limit**.
2. Select **Edit allocations** to open the **Stock** section in Experience Settings.
3. Enter updated totals for each size. **Fanfare-managed** fields show your **Up to** ceiling (what the experience currently holds plus the product's **Available** stock).
4. Select **Save**.

For non-Fanfare-managed sizes, saving here applies one shared limit to every sequence holding that size.

When you lower a **Fanfare-managed** size, Fanfare reclaims units from **Unassigned** first, then from sequences (newest first), previewing the change before you save. Fanfare blocks any reduction that would pull units from a sequence already counting stock.

![The Stock card on an experience, showing for each size of Court Classic Low its allocation, the share held by the Summer access sequence, unassigned and sold units and what is still available to allocate, with the Edit allocations button ringed.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/stock-allocation-experience-card.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=ce98ac317805bff554cc9c58b3daac94)

You can adjust experience-level allocations until the drop goes live.

> [!WARNING]
>
> Once any sequence in the experience goes live, experience totals lock (**Fixed while live**). Only units left **Unassigned** remain as a reserve you can transfer to sequences mid-drop via **Move units**. After the drop ends, allocations remain permanently locked.

You can't remove a product from an experience while it still holds allocated units. Before the drop opens, select **Keep** if prompted, open **Stock**, set all of that product's sizes to `0`, and save—then remove the product under **Products**.

## Split units across sequences

Each sequence has its own **Stock** card on its **Overview** tab:

1. Open the sequence from the experience's **Overview**.
2. On the **Stock** card, select **Edit allocations** (or select **Edit → Stock**).
3. Enter a **Quantity** (`0` to `1,000,000`) for each size—or select **No limit** on non-Fanfare-managed sizes (not available on **Fanfare-managed** sizes or Dutch auctions).
4. Select **Save**.

What each column shows:

* **Quantity:** Units this sequence can sell.
* **Unassigned:** For **Fanfare-managed** sizes, units held by the experience that no sequence has claimed yet, along with the **Up to** ceiling you can raise this sequence to.
* **Sold:** Units this sequence has already sold.
* **Manual planning inventory:** Shown for **Not managed** products. Warns when your combined sequence limits exceed the reference quantity on the product, without blocking saves.

If a row blocks **Save**, check the reason:

| Message | How to fix it |
| - | - |
| *"Can't go below 3: 3 already sold"* | A size can never be set lower than what it has already sold. |
| *"Stock is counting, so this size can only go up here. Use Move units to take units out."* | Counting has started, so you can't lower a quantity here. Select the **Move** button beside the row (for example, **Move M**) to transfer units out via **Move units**. |
| *"At most 40: the experience has no more unassigned units of this size"* | Before the drop goes live, raise the experience's allocation (recording a receipt first if needed). Once live, experience totals lock—transfer stock in from another sequence with **Move units**. |

If a teammate updates stock while you're editing, Fanfare reloads the grid, preserves your non-conflicting changes, and lets you review and save again.

**Default starting values:** **Fanfare-managed** sizes (and most other sizes) default to `0` and open sold out. **Shopify-managed** sizes start at Shopify's count, and non-managed sizes in timed releases or under external checkout start at **No limit**.

> [!WARNING]
>
> Stock counting starts about 10 minutes before a sequence opens. From that point on, you can only raise quantities in this grid—taking units out requires **Move units**. Any size left at `0` opens sold out, so finalize every size before that 10-minute mark.

![A sequence's stock settings after counting has started: US 9 was lowered to 35 and is refused with a message to use Move units instead, with a Move US 9 button beside it and Save disabled.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/stock-allocation-sequence-grid-locked.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=ab7e8fc57723d2b67f2216e43fe22edd)

Once stock counting starts, lowering a quantity is blocked and you'll use Move units instead.

## Once counting starts

The sequence's **Stock** card tracks live status for every size:

| Status | What it means |
| - | - |
| **Not counting yet** | Counting hasn't begun. Before a sequence's first drop counts, quantities can move up or down; afterward, they only move up here. |
| **Ready** | Stock is prepared for the upcoming drop; live figures appear when doors open. |
| **Opens sold out** | Nothing left to sell (set to `0` or already sold out), so shoppers see it sold out at open. |
| **Preparing** | Counting is starting now—live figures appear within a minute. |
| **Selling** | The drop is open and units are available. |
| **Sold out right now** | All allocated units are sold and none are in checkout. |
| **Held: stock** | Another size is over-allocated, preventing the entire sequence from opening. The over-allocated size itself shows **Over-allocated by**. |
| **Released** | The sequence ended and unused stock returned to the experience. |

![A sequence's Stock card before counting starts, with a notice that counting starts about 10 minutes before the sequence opens, and US 9 at 0 marked Opens sold out.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/stock-allocation-opens-sold-out.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=f918b677ab86a743edb4ad48a270e7cd)

Any size left at 0 shows Opens sold out until you allocate units to it.

To restock a sold-out size mid-drop, raise its **Quantity** (up to **Unassigned** for Fanfare-managed sizes) or transfer stock from another sequence with **Move units**. See [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md) for step-by-step instructions (including how moving stock affects draw winner counts) and [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md) for the customer view.

## Over-allocated and held sizes

If a **Fanfare-managed** size's total allocations exceed its product **Supply** before doors open, the experience's **Stock** card alerts you that the drop won't start selling until you resolve it, with direct **Resolve** and **Record a receipt of at least …** actions. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md) for how both options work.

## After the drop

For **Fanfare-managed** products, once every distribution in a sequence finishes, its allocation drops to what it sold and leftover units return to the experience as **Unassigned**. Once at least one sequence has released and no other sequence still holds active Fanfare-managed units, the experience releases its leftover units back to product **Available** stock. Release is final—see [Stock](https://docs.fanfare.io/concepts/stock.md).

Sequences without Fanfare-managed units don't release; their stock grid stays open after the drop, keeping the same upward-only rule.

## Field reference

| Setting | What it does | Default | Editable while live? |
| - | - | - | - |
| **Units** (wizard **Stock** step) | Starting units per size for the experience and its first sequence. | `0` for Fanfare-managed sizes and every size in a Dutch auction; Shopify's count for Shopify-managed sizes in a queue or draw; **No limit** for other non-Fanfare-managed sizes in a timed release, your own checkout, or more than 256 size combinations; `0` for all other sizes | Creation only—adjust later on the experience's **Stock** card |
| **Experience units** (Experience Settings → **Stock**) | Experience-level pool for Fanfare-managed sizes, or one shared limit across sequences for other products. | Set by the wizard | No—locks while the drop is live |
| **Quantity** (sequence grid) | Units this sequence can sell. | Same defaults as above | Upward only once counting starts; move units out with [Move units](https://docs.fanfare.io/guide/drop/live-controls.md) |
| **No limit** (sequence grid) | Never caps sales or marks the size sold out. | Off, except the cases above | Yes—once counting starts, a **No limit** size can't be switched to a fixed number |

## Things to know before you go live

* **No limit locks once counting starts:** A size set to **No limit** never sells out in Fanfare, and you can't switch it back to a fixed count once counting begins.
* **256 size-combination limit:** A sequence offering more than 256 size combinations refuses new shoppers once counting starts. Trim products or variants down to 256 or fewer before launch. (For Mystery Box sequences, see [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md).)
* **Separate Save button:** The sequence's **Stock** section saves independently from **Settings** and **Order limits**.

## On Shopify

* Products imported from Shopify while your checkout processor is **External** are **Shopify-managed**. Experience-level **Available**/**Unassigned** pools, held sizes, and post-drop release don't apply—each sequence's **Quantity** is its cap. (Products imported after switching to Fanfare checkout are **Fanfare-managed**; see [Manage stock](https://docs.fanfare.io/guide/create/stock.md#on-shopify).)
* For a **Shopify-managed** size in a queue or draw, the wizard's **Stock** step shows a **Shopify count** column and pre-fills each size with Shopify's live count (**Shopify's count at creation**). It stays synced to Shopify's count until counting starts or you type a custom number. For draws, winner count follows that total at creation.
* If Shopify reports a size sold out, that size stops selling in the sequence. Raise its **Quantity** to reopen it—unless an earlier distribution in the same sequence is still running, in which case wait for that earlier drop to finish first. You can't move units into or out of a size while Shopify marks it sold out.
* During a live drop, the sequence's **Stock** card warns you if Shopify's inventory drops below what the drop has left or what's currently in checkout.

For full sync details, see [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md).

## Troubleshooting

> [accordion] I can't lower a size's quantity
>
> Stock counting has already started for that sequence. Use **Move units** to transfer stock out instead—see [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

> [accordion] Save is blocked because there are no more unassigned units
>
> The experience has no **Unassigned** units left for that size. Before the drop goes live, select **Edit allocations** on the experience's **Stock** card to add units (recording a receipt on the product first if needed; see [Manage stock](https://docs.fanfare.io/guide/create/stock.md)). Once live, experience totals lock—transfer units from another sequence with **Move units**.

> [accordion] A size shows Opens sold out
>
> The size has `0` units left to sell (either set to `0` or already sold through its allocation). Raise its **Quantity** in the sequence grid or transfer stock in with **Move units**.

## Related

> [card] [Stock](https://docs.fanfare.io/concepts/stock.md)
>
> How inventory flows from supply to experiences, sequences, and sales.

> [card] [Manage stock](https://docs.fanfare.io/guide/create/stock.md)
>
> Stock modes, Adjust stock, and resolving over-allocated sizes.

> [card] [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md)
>
> Move units between sequences while a drop is running.

> [card] [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md)
>
> Create sequences and choose Customer Picks or Mystery Box.


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