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

# Troubleshooting a live drop

> Quickly diagnose and fix access issues, stalled queues, stock surprises, metric questions, and Shopify checkout errors while a drop is live.

Use this guide when something looks off while your drop is **Live**. Most edits take effect as soon as you save ([Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md)), while **Deactivate** ends a drop permanently and can't be undone ([Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md)).

## Customers can't get in

> [accordion] 'Access unavailable: This experience is for members of a specific group.'
>
> The customer is signed in, but isn't a member of any gating audience that matches their sequence (signing in again won't fix it). Verify they belong to the audience, and confirm the audience status is **Live**—audiences showing **Not built yet**, **Building**, **Queued**, or **Build failed** don't admit anyone. See [Audiences and access codes](https://docs.fanfare.io/concepts/audiences.md) and [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md).

> [accordion] 'No current access window'
>
> The sequence the customer was routed into doesn't have an open or upcoming distribution. Check that sequence's distribution schedule. See [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md) and [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

> [accordion] Customers land in the wrong sequence (for example, VIPs see the public draw)
>
> Fanfare routes customers in a fixed order: open sequences always come before scheduled ones regardless of priority; among sequences in the same state, immediate entry beats sequences requiring sign-in or a code; after that, lower priority number (earlier creation order, which can't be changed in the admin) wins. Also confirm members are signed in—Fanfare can't identify an audience member until they sign in. See [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md).

> [accordion] 'Invalid access code'
>
> The code doesn't match the sequence's current **Shared access code**. Updating a code invalidates the old one immediately for anyone who hasn't entered yet. Share the active code or restore the previous one on the sequence's **Access** tab. (Codes aren't case-sensitive, and turning the code off doesn't trigger this error.) See [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md).

> [accordion] Guests are forced to sign in and don't see 'Continue as guest'
>
> Guest entry only appears when the sequence has no audience *and* every open or scheduled distribution in it has **Allow guest access** enabled. Any open or scheduled auction or appointment requires sign-in for the entire sequence. See [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md).

> [accordion] 'Too many failed verification attempts. Please try again later.'
>
> The customer exceeded the verification retry limit. They can try again after the time shown beside **Blocked until**—there's nothing to reset in the admin.

## Nobody is being admitted

> [accordion] The queue shows a Paused badge
>
> Someone paused the queue—waiting shoppers keep their spot, but admissions stop. Open the queue card's menu and select **Resume queue** to restart at the previous admit rate. See [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

> [accordion] Nobody is admitted, but there's no Paused badge or Resume queue option
>
> **Admit rate** was set to `0` in **Edit**. Setting the rate to `0` overwrites your pace instead of pausing, so **Resume queue** won't appear. Open **Edit** on the queue card and raise **Admit rate**. See [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

> [accordion] Customers see 'Entry is paused. Your place in line is saved.'
>
> This means the queue has no free units to admit right now—not that you paused it manually. Either every remaining unit is currently held in active checkouts, or stock isn't ready yet. Check the sequence's **Stock** card:
>
> * If all units are **In checkout**, the line will move automatically when checkouts expire or when you add inventory with **Move units** (once everything sells, customers see "Everything claimed").
> * If the **Stock** card shows **Not counting yet**, **Counting is paused**, or **Held: stock**, follow the on-card prompt (such as **Resolve** for an over-allocated size). Sequences exceeding 256 size combinations also block admissions (see below). If the card shows no issue, contact support. See [Stock](https://docs.fanfare.io/concepts/stock.md) and [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

## Sold out sooner than expected

> [accordion] A size shows sold out at or right after opening
>
> Any Fanfare-managed size left without an allocation starts at `0` and opens sold out. While live, add inventory with **Move units** (from **Unassigned** or another sequence) or increase it in **Edit allocations** using unassigned stock.
>
> Also check for "More than 256 size combinations: new shoppers are refused"—sequences with more than 256 size combinations block new entries. To fix it, reduce the number of products or sizes in the sequence (product selection can't be edited while a distribution is open, settling, or holding entrants). See [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md) and [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

> [accordion] A draw's winner count changed on its own
>
> While a draw is still selecting winners, moving units into its sequence raises **Winner count** and moving units out lowers it automatically. See [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md).

## Customers got in but didn't buy

> [accordion] A customer's payment window ran out
>
> Their checkout timer expired and their spot was released. Note that the automated expiration email and text say they can enter again while open, even though draws never select the same winner twice and lapsed English auction wins stay unsold—the widget always reflects what's actually allowed.
>
> If you use pre-authorization, card holds expire after about 7 days, so customers who entered too far ahead of selection lose their allocation when their hold lapses. See [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md) and [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md).

## Customers didn't get a message

> [accordion] A guest who won or was admitted received no notification
>
> Guests never receive emails or texts—they only see updates if they keep the drop page open. See [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

> [accordion] A customer joined the waitlist and got no confirmation
>
> Self-serve waitlist sign-ups don't send a confirmation email or text. Only people you add manually in the admin receive one. See [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md).

> [accordion] The 'opens soon' email showed an internal name like 'Queue 2'
>
> Waitlist "opens soon" emails display the distribution's exact name from your admin. Rename future distributions with customer-facing labels before opening. See [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md).

## The numbers look wrong

> [accordion] Live now is much larger than the queue, or Waiting in queue reads 0 for a draw
>
> **Live now** combines *current* people waiting in live queues with *cumulative* entrants across every other live distribution type. In addition, only queues have their own live screen; draws, auctions, timed releases, and appointments use the queue's screen, so **Waiting in queue** always reads `0` for them. Read **Entrants** on the individual cards instead. See [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md).

> [accordion] Entries on Home doesn't match Entrants, or Paid orders includes refunds
>
> **Entries** on **Home** (titled **Dashboard**) counts every individual entry—one shopper entering three distributions counts three times—while **Entrants** in **Performance** counts unique customers. **Paid orders** also includes orders that were later fully refunded. See [Read your results](https://docs.fanfare.io/guide/learn/performance.md).

> [accordion] The numbers stopped updating
>
> On **Home**, auto-refresh switches to **Auto-refresh Off** after an error—select it to turn auto-refresh back on, or select **Refresh**. On live drop screens, updates pause whenever the browser tab is hidden and resume once you bring the tab back to the front. See [Read your results](https://docs.fanfare.io/guide/learn/performance.md) and [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md).

## You can't change a setting

> [accordion] Save is grayed out or refused, or a field shows Locked
>
> Several settings lock once a distribution counts as opened, and closed distributions can't move schedules. **Save** also stays disabled when a field fails validation—for example, if a window overlaps another distribution in the same sequence or a draw's **Closes** time is earlier than its **Draw date**. See [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md) and [What locks, and when](https://docs.fanfare.io/concepts/what-locks-when.md).

> [accordion] 'Publishing is frozen' when republishing the hosted page
>
> Republishing an already-live hosted page freezes 15 minutes before a distribution opens until it closes (or 30 minutes after opening if it has no close time). If you need an urgent change, an admin can type `PUBLISH` and select **Override freeze and publish**—this updates the live page immediately for active shoppers. See [Build and publish the hosted page](https://docs.fanfare.io/guide/create/hosted-page.md).

> [accordion] An audience rule change or Refresh now isn't applying
>
> While a gated distribution is taking entries, any previously built **Dynamic** audience is **Held**: full rebuilds pause, **Refresh now** is disabled, and rule changes apply to the full list after close (though an individual customer whose profile updates is re-checked right away). No hold applies if an open queue, timed release, or appointment has no **Closes** time. See [Audiences and access codes](https://docs.fanfare.io/concepts/audiences.md).

## After you stopped a drop

> [accordion] You deactivated one sequence and the public page shows the whole experience as ended
>
> Deactivating any single distribution or sequence marks your entire public hosted page as ended—there's no way to keep the shared page open for other sequences in that experience. See [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

> [accordion] Deactivation didn't reach every page, or Delete is refused afterward
>
> If Fanfare warns that deactivation hasn't reached every live page yet, run **Deactivate** again to finish propagating it.
>
> After deactivating, **Delete** is refused while active payment windows wind down (about 90 minutes with the default window, or about 2 hours for a draw), even though the button looks available. Wait for the wind-down period to finish, then delete. See [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

## On Shopify

Everything above applies in the Fanfare app in Shopify (except appointments, which aren't offered). Use these checks for Shopify-specific issues:

> [accordion] Someone bought a protected product without going through the drop
>
> Check that both storefront setup steps are complete, that the Fanfare checkout validation rule is active, and that **Allow all customers to complete checkout** isn't checked ([Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md)). If protection failed to apply after saving an experience, see the gating warning item below.

> [accordion] 'Please claim access to this product before adding it to your cart' or 'These products can't be purchased together'
>
> Shopify checkout protection blocked the order:
>
> * **Claim access message:** The shopper bypassed the drop (for example, via a direct cart link or quick-add button) or their payment window expired. Direct them back to the product page to enter through the Fanfare widget.
> * **Can't be purchased together:** Their cart contains products from two different Fanfare experiences—they need to check out each separately. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

> [accordion] 'Experience saved, but Shopify gating could not be updated for…' stays on screen
>
> The experience saved, but checkout protection failed to sync for the listed Shopify product IDs—meaning those products may still be unprotected. Open the experience settings and save again to retry. If this happened right after creating the experience, see [When protection did not update](https://docs.fanfare.io/guide/shopify/checkout-protection.md#when-protection-did-not-update).

> [accordion] A product still can't be bought normally after the drop ended
>
> **Deactivate** leaves Shopify checkout protection in place. To release a product back to normal storefront checkout, **Delete** the experience or remove the product from it. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

> [accordion] Home shows Quick Actions instead of your experiences
>
> If Fanfare couldn't confirm your session when **Home** loaded, it falls back to **Quick Actions** instead of showing an error. Open **Experiences** to verify your drops are intact, and reload the browser page (the **Refresh** button on Home won't reload the list).

> [accordion] You refunded or canceled an order in Shopify, but Fanfare still shows it as paid
>
> Refunding, canceling, or editing an order in Shopify doesn't update Fanfare's order record or revenue totals. See [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md).

## Related

> [card] [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md)
>
> Pause a queue, adjust settings, move units, or cancel bookings live.

> [card] [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md)
>
> Understand every live metric and refresh interval.

> [card] [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md)
>
> Review every customer screen, gate, and automated message.

> [card] [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md)
>
> Deactivate a live drop or delete an ended one.

> [card] [Before doors open](https://docs.fanfare.io/guide/drop/preflight.md)
>
> Run through the pre-launch checklist and automatic lock countdown.


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