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

# Timed release

> Launch a product at a set time for everyone at once—first come, first served—with instant stock holds and no waiting room.

A **timed release** opens your drop to everyone in the sequence at a scheduled time—first come, first served, with no waiting room and no admission pacing. Choose a timed release for standard launches where you want a clean countdown into immediate checkout access.

If you expect heavy demand spikes and want to pace checkout traffic smoothly, use a [queue](https://docs.fanfare.io/concepts/distributions/queue.md) instead. See [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md) to compare all five types.

> [!TIP]
>
> On your customer-facing page, a timed release displays as **"Flash Sale"** with an **"Enter sale"** button—helpful to recognize when previewing your drop.

## How it works

Set **Opens**, **Closes**, and **Time zone** (defaults to your experience's time zone), plus optional **Allow guest access** (off by default; unavailable when gated by an audience) and **Automatic entry** (off by default). There's no payment collection step to configure. See [Set up a timed release](https://docs.fanfare.io/guide/create/timed-release.md) for step-by-step setup.

Before **Opens**, customers see a **"Coming Soon"** countdown and can join the sequence waitlist via **"Enter waitlist"** (signed-out visitors see **"Sign in to get notified"**). See [Waitlists](https://docs.fanfare.io/concepts/waitlists.md).

Once the sale opens, shoppers pick their item or size (if applicable) and click **Enter sale** to claim a spot.

### Entering holds a unit

On a stock-counted sequence, clicking **Enter sale** reserves one unit of the shopper's chosen item immediately while they check out. That hold remains in place until:

* They complete payment and purchase the unit, or
* Their 30-minute checkout window expires and the unit returns to available stock.

Shoppers can't release a hold early. If all units of an option are already held or sold, Fanfare keeps the shopper on the page and displays **"That option just sold out — pick another"** beside **Enter sale** or the item picker. They can choose a different size or click **Enter sale** again later—if another shopper's hold expires in the meantime, they'll get in.

> [!WARNING]
>
> Timed releases can sell out at the moment of entry rather than checkout. Shoppers who see an option sold out may still claim a unit later if someone else's checkout window expires.

![Units on sale sit in a row. A customer who enters holds one unit until they pay or their time runs out. If they pay, the unit is sold. If their time runs out, the unit goes back on sale. When no unit is free, entry is refused: the customer stays on the sale and sees "That option just sold out — pick another" next to "Enter sale", which they can select again. They get in if a unit has come back.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/concepts-timed-release-entry-holds-a-unit.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=67d6bbbc9d7c4b4c871d632c86397e4d)

On a stock-counted sequence, entering a timed release holds one unit until the shopper pays or their checkout window expires.

Stock holds work identically whether inventory is managed in Fanfare or Shopify. However, on sequences running only timed releases, externally managed products (including Shopify-managed inventory) default to **no limit** on Fanfare's side so entry isn't capped before checkout. See [Stock](https://docs.fanfare.io/concepts/stock.md) for details on counted vs. unlimited sizes.

### Automatic entry on counted sequences

When **Automatic entry** is on, Fanfare normally admits shoppers automatically as soon as they reach the drop. On a timed release whose sequence counts a size that can run out, automatic entry isn't active—shoppers click **Enter sale** themselves (your toggle setting is still saved). If no size has a stock cap and there's no item selector, automatic entry works as expected.

### Not compatible with Mystery Box

Timed releases can't run on a sequence using **Mystery Box** product selection. You can't add a timed release to a Mystery Box sequence—or switch a sequence with a timed release to Mystery Box—without seeing **"Timed release can't be combined with Mystery Box products"**. See [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md).

### Payment and take rate

Customers always pay at checkout after entering—there are no card pre-authorizations on timed releases. Every admitted shopper gets a fixed **30-minute payment window** (not configurable). If their window expires while the release is still open, they see **"Access expired"** and can return to click **Enter sale** again.

See [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) for more on checkout windows. Orders paid through Fanfare checkout or Shopify checkout use the lower **Timed-release take rate**—see [Payments and fees](https://docs.fanfare.io/guide/account/payments.md).

## Good to know

* **Guest shoppers:** When **Allow guest access** is enabled, guests don't receive emails or texts and can only return to their session from the same browser. See [Customers and identity](https://docs.fanfare.io/concepts/customers.md).
* **Loyalty points:** Entering a timed release doesn't award participation points, though completed purchases still earn purchase points as usual. See [Loyalty and Fanfair](https://docs.fanfare.io/concepts/loyalty.md).
* **No overlapping windows:** Distributions in one sequence can't overlap. Use separate sequences to run timed releases simultaneously for different audiences. See [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md).
* **Customer-visible names:** Your distribution name appears in default waitlist "opens soon" emails, so give it a clear public title. See [Waitlists](https://docs.fanfare.io/concepts/waitlists.md).
* **Minimal locking:** Beyond standard schedule rules, timed releases have no extra settings that lock after opening. See [What locks, and when](https://docs.fanfare.io/concepts/what-locks-when.md).

## Lifecycle and deactivation

A timed release moves from **Scheduled** to **Live** at **Opens**, and to **Ended** at **Closes** with no settling phase.

Choosing **Deactivate** ends the release immediately (showing **Ended early** if stopped before **Closes**). Admitted shoppers who haven't started checkout lose their hold, while shoppers already checking out can finish paying within their 30-minute window. Paid orders stay intact, and deactivation can't be undone. See [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

## What your customers see

* **Before opening:** **"Coming Soon"** with a countdown and **"Enter waitlist"** for signed-in shoppers.
* **While live:** **"Flash Sale"** with a **"Window closes in"** countdown, optional item selector, and **Enter sale**.
* **Admitted:** **"You're in"** with a **"Your checkout time"** countdown and **Continue to checkout**.
* **Sold out:** **"That option just sold out — pick another"** alongside **Enter sale** while live; **"Ended"** once the release closes.
* **Window expired:** **"Access expired"** (they can click **Enter sale** again while the release remains open).

See [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md) for every stage and notification.

## Example: running a timed release

Northbound Supply Co. launches the KaiZen Relic through a **Sneaker Club Release** sequence gated to their Sneaker Club audience (so guest access is off). The timed release runs for four hours with 300 pairs counted in stock:

1. At **Opens**, Sneaker Club members sign in and click **Enter sale**. The first 300 shoppers immediately hold one pair each and see **"You're in"** with their 30-minute checkout countdown.
2. Shopper 301 clicks **Enter sale** moments later. All 300 pairs are currently held, so they see **"That option just sold out — pick another"** and stay on the page.
3. One of the first 300 shoppers lets their checkout window expire without paying, automatically releasing their pair back into stock.
4. Shopper 301 clicks **Enter sale** again, claims the returned pair, and completes checkout.
5. Four hours later, the release closes and remaining visitors see **"Ended"**.

## Related

> [card] [Set up a timed release](https://docs.fanfare.io/guide/create/timed-release.md)
>
> Step-by-step instructions and settings for adding a timed release.

> [card] [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md)
>
> Compare all five distribution types and how their schedules work.

> [card] [Stock](https://docs.fanfare.io/concepts/stock.md)
>
> Understand counted stock, holds, and unlimited sizes.

> [card] [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md)
>
> Preview every customer screen and notification.


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