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

# Glossary

> Definitions for the terms used across the Fanfare admin, Shopify app, and developer docs.

Use this glossary to look up terms you'll encounter in the Fanfare admin, the Fanfare app in Shopify, and messages from Fanfare. Each entry links to the guide that explains it in detail. When the API or SDK docs use a different name, it's listed under **API term** (a blank cell means they use the same term).

Looking for specific values or rules? See [Status reference](https://docs.fanfare.io/guide/reference/statuses.md), [Limits and defaults](https://docs.fanfare.io/guide/reference/limits.md), [What locks, and when](https://docs.fanfare.io/concepts/what-locks-when.md), and [Things that cannot be undone](https://docs.fanfare.io/guide/reference/cannot-be-undone.md).

## Drops

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Admit rate** | The maximum number of customers a queue lets in per minute. Sets the pace, not the total capacity. | | [Queue](https://docs.fanfare.io/concepts/distributions/queue.md) |
| **Allocation Percentages** | In a **Mystery Box** sequence, each product's share of random assignments. Separate from stock allocation. | allocation weights | [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md) |
| **Appointment** | A distribution for booking time slots instead of buying products. Appointments don't collect payment. | | [Appointment](https://docs.fanfare.io/concepts/distributions/appointment.md) |
| **Auction** | A distribution where bidding sets the price—either **English** (highest bid wins) or **Dutch** (a falling price goes to whoever accepts it first). | | [Auction](https://docs.fanfare.io/concepts/distributions/auction.md) |
| **Automatic entry** | Enters customers into a queue, draw, or timed release as soon as they arrive, without clicking a button. Off by default, and doesn't apply when customers pick their product, when a card hold is placed on entry, or on a timed release with Fanfare-counted stock. | | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| **Bias toward loyal consumers** | Weights a draw's random selection or a queue's early-arrival order using loyalty points. This guide calls it Fanfair loyalty prioritization. | | [Loyalty and Fanfair](https://docs.fanfare.io/concepts/loyalty.md) |
| **Customer Picks** | The default product selection mode, where each customer chooses their own product. | | [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md) |
| **Deactivate** | Permanently ends a distribution, sequence, or experience right away. It's not a pause and can't be undone. | | [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md) |
| **Delete** | Permanently removes a distribution, sequence, or experience from your admin once nothing in it is live, scheduled, or still winding down. Deactivate anything live or scheduled first. | | [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md) |
| Distribution | How a sequence releases products during a time window—a queue, draw, auction, timed release, or appointment. | mechanism (the type) | [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md) |
| **Draw** | A distribution that selects winners at random from all entrants, so arriving early gives no advantage. | | [Draw](https://docs.fanfare.io/concepts/distributions/draw.md) |
| **Draw at** | When a draw runs its first winner selection. Labeled **Draw date** in the experience wizard and edit dialog. | | [Draw](https://docs.fanfare.io/concepts/distributions/draw.md) |
| Drop | The launch event an experience powers—not a separate object. Appears in admin labels like **By drop** on **Usage**. | | [Experiences](https://docs.fanfare.io/concepts/experiences.md) |
| **Ended early** | Shown on a distribution deactivated before its scheduled close, and on a sequence or experience that stopped with a deactivated distribution inside it. | | [Experiences](https://docs.fanfare.io/concepts/experiences.md) |
| **Experience** | The container for a drop, holding its products, time zone, design, announcements, and one or more sequences. | | [Experiences](https://docs.fanfare.io/concepts/experiences.md) |
| **Mystery Box** | The product selection mode where Fanfare assigns each customer a product at random based on your configured weights. | | [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md) |
| **Opens** and **Closes** | The start and end of a distribution's window. An experience's own **Opens** and **Closes** times are calculated from its distributions. | | [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md) |
| **Pause queue** | Temporarily stops a live queue from admitting shoppers while everyone keeps their place. Select **Resume queue** to start admitting again. | | [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md) |
| **Priority** | The order in which Fanfare offers sequences to customers (shown as P1, P2, and so on—lowest number first), set by creation order. | | [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md) |
| **Queue** | A distribution that admits customers at a steady pace. Early arrivals are shuffled once at open, then entry is first come, first served. | | [Queue](https://docs.fanfare.io/concepts/distributions/queue.md) |
| Sequence | One entry path into an experience, with its own access gates, share of stock, distributions, and waitlist. | | [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md) |
| **Settles** | When auction bidding is scheduled to end unless a late bid extends it (labeled **Settle at** when adding an auction). The auction settles from then until **Closes**. | | [Auction](https://docs.fanfare.io/concepts/distributions/auction.md) |
| Status chip | The badge showing the current state of an experience, sequence, distribution, order, or audience. | | [Status reference](https://docs.fanfare.io/guide/reference/statuses.md) |
| **Timed Release** | A distribution that opens sales to everyone at a set time with no line. Customers see it titled "Flash Sale". | | [Timed release](https://docs.fanfare.io/concepts/distributions/timed-release.md) |
| Waiting room | The 5-minute window before a queue's **Opens** time when customers can join, before anyone is admitted. | | [Queue](https://docs.fanfare.io/concepts/distributions/queue.md) |
| **Waitlist** | Each sequence's notification list for customers who want to know when it opens (not a distribution). Accepts sign-ups while nothing in the sequence is live and more is coming, or nothing is scheduled yet. | | [Waitlists](https://docs.fanfare.io/concepts/waitlists.md) |
| **Winner count** | How many winners a draw targets. When every variant has a fixed unit count, it can't exceed those total units. | | [Draw](https://docs.fanfare.io/concepts/distributions/draw.md) |

## Admission and payment

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| Admission | A time-limited right to buy one unit, granted when a customer gets through a distribution. | grant | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| **Admission expiration** | A draw's payment window, configured in seconds on the draw. | | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| **Authorization amount** | The single amount held on each customer's card when a queue or draw uses pre-authorization. Every product offered must match this exact price. | | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| **Checkout processor** | Your organization's choice of who takes payment: **Fanfare** for Fanfare checkout, or **External** for your own store checkout or Shopify checkout. | | [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md) |
| **Custom rate** | A negotiated Fanfare fee that replaces your plan's standard take rates and carries over if you change plans. | | [Payments and fees](https://docs.fanfare.io/guide/account/payments.md) |
| **Fanfare fee** | The fee Fanfare deducts from each paid order, shown on the order's **Payment** card. Refunding an order doesn't return this fee. | | [Payments and fees](https://docs.fanfare.io/guide/account/payments.md) |
| **Payment collection** | When a queue or draw collects payment—afterward (**Pay when admitted**, **Pay after the win**) or upfront as a card hold (**Pre-authorise on joining**, **Pre-authorise on entry**). | | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| Payment window | How long an admitted customer has to pay before losing their unit. On a draw, this is set by **Admission expiration**. | access window | [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| Take rate | Fanfare's percentage fee on each paid order, determined by your plan (or custom rate) and the distribution type. Custom rates can vary by checkout. | | [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md) |

## Products and stock

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Adjustment**, **Receipt**, **Write-off** | Stock history entries for count corrections, newly received units, and lost, damaged, or unsellable units. | | [Manage stock](https://docs.fanfare.io/guide/create/stock.md) |
| **Allocated** | Units of a variant reserved for your experiences. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **At risk** | Units in active checkouts that **On hand** inventory no longer covers (normally 0). | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Available** | **Supply** minus **Allocated**—units still free to assign to an experience (negative if over-allocated). | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| Counting | Live stock tracking for a sequence, starting about 10 minutes before it opens. Once counting starts, variant allocations can only increase. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Held: stock** | A sequence paused from opening because a variant's supply fell below its allocation. Clears once supply covers the allocation again. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **In checkout** | Units temporarily held by admitted customers while they complete payment. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Location** | A physical venue where an appointment runs, with an address, time zone, and opening hours used to generate bookable slots. | | [Locations and opening hours](https://docs.fanfare.io/guide/create/locations.md) |
| **Move units** | Moves units to another sequence in the same experience or back to **Unassigned**—the only way to take units out of a counting sequence. | | [Change things mid-drop](https://docs.fanfare.io/guide/drop/live-controls.md) |
| **On hand** | **Supply** minus **Sold**. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Opens sold out** | Shown on a variant with no units assigned in a sequence. Customers can't buy it until you allocate units. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Product** | Anything an experience sells or grants access to. Add a product once and attach it to as many experiences as you like. | | [Add products](https://docs.fanfare.io/guide/create/products.md) |
| **Released** | A sequence that has finished selling. Its unsold units return to the experience, and its stock can no longer change. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Sold** | Units with captured payments. Refunding an order doesn't reduce this count. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Stock management** | Who tracks a product's count, locked when the product is created: **Fanfare-managed**, **Not managed**, or **Shopify-managed** (for Shopify products when not using Fanfare checkout). | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Supply** | Opening stock plus every receipt, adjustment, write-off, and return recorded since. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Unassigned** | Units allocated to an experience that haven't been assigned to any sequence yet. | | [Stock](https://docs.fanfare.io/concepts/stock.md) |
| **Variant** | One size, color, or other option of a product. Stock screens refer to each variant as a size. | | [Add products](https://docs.fanfare.io/guide/create/products.md) |

## Customers and access

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Audience** | A named customer group that controls who can enter a sequence and who receives its invite: **Dynamic**, **Static List**, or **Imported**. | | [Audiences and access codes](https://docs.fanfare.io/concepts/audiences.md) |
| Build | When Fanfare computes an audience's member list from scratch. While a drop it gates is open, a **Dynamic** audience stays **Held**. | | [Audiences and access codes](https://docs.fanfare.io/concepts/audiences.md) |
| **Customer** | A person with a profile in your organization. The API, SDK docs, and a few admin labels refer to them as a consumer. | consumer | [Customers and identity](https://docs.fanfare.io/concepts/customers.md) |
| Guest and signed-in customer | Signed-in customers verify with a one-time code. Guests choose "Continue as guest", receive no messages, and can only return from the same browser. | | [Customers and identity](https://docs.fanfare.io/concepts/customers.md) |
| Invite | The email a sequence sends to its audience members inviting them to enter. | | [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md) |
| Loyalty points | Points a signed-in customer earns from purchases and drop participation. They can't be redeemed directly, and power loyalty audiences and Fanfair prioritization. | | [Loyalty and Fanfair](https://docs.fanfare.io/concepts/loyalty.md) |
| **Loyalty tiers** | A group of 2 to 10 rule-based audiences, each covering a range of one customer field such as lifetime points. | | [Loyalty and Fanfair](https://docs.fanfare.io/concepts/loyalty.md) |
| **Order limits** | The maximum quantity one customer can buy—set on a sequence, but counted across the whole experience. | purchase limits | [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md) |
| Organization admin and member | The two team roles. Only an admin can manage payments, billing, the checkout processor, developer settings, email sender and SMS settings, publish pages, or deactivate drops. | | [Team members](https://docs.fanfare.io/guide/account/team.md) |
| **Shared access code** | A single code you distribute that customers type to unlock a sequence. Access codes aren't case-sensitive. | | [Sequences and routing](https://docs.fanfare.io/concepts/sequences.md) |
| **Wallet pass** | A loyalty pass for Apple Wallet or Google Wallet showing a customer's points balance. | | [Loyalty and Fanfair](https://docs.fanfare.io/concepts/loyalty.md) |

## Orders

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Order** | A customer's purchase, listed under **Orders**. With Fanfare checkout, an order appears once payment is submitted or a pre-authorized card hold is captured. | | [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md) |
| **Order status** | The current state of an order. See [Status reference](https://docs.fanfare.io/guide/reference/statuses.md) for every value. | | [Status reference](https://docs.fanfare.io/guide/reference/statuses.md) |
| **Payment status** | The state of an order's payment, shown below the order status when it adds detail. | | [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md) |
| **Refund** | Returns money to a customer on a paid order. Refunds don't return the Fanfare fee or automatically return units to stock. | | [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md) |
| **Return to stock** and **Keep out of stock** | Your choice per refunded Fanfare-managed item on whether its units go back into **Supply**. | | [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md) |
| Test order | An order placed with a test payment method—badged **Test** and excluded from revenue, purchase limits, and customer metrics. | | [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md) |

## Pages, designs, and messages

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Announcement** | An email, text message, or social post you write and schedule in an experience's **Marketing Hub**. | | [Announcements](https://docs.fanfare.io/guide/create/announcements.md) |
| **Brand** | Your organization's logo, colors, and fonts, applied across every experience. Edits reach live pages right away without republishing. | | [Brand, templates and designs](https://docs.fanfare.io/concepts/design.md) |
| **Design Studio** | Where you manage your brand and store reusable templates and widget designs. | | [Templates and widget designs](https://docs.fanfare.io/guide/create/templates.md) |
| **Email Sender** | Settings for the sender name, reply-to address, physical address, and sending domains on emails Fanfare sends for you. | | [Sender identity and sending domain](https://docs.fanfare.io/guide/create/email-sender.md) |
| **Hosted page** | An optional web page Fanfare hosts for an experience at a shareable URL. | | [Build and publish the hosted page](https://docs.fanfare.io/guide/create/hosted-page.md) |
| "Opens soon" message | The reminder Fanfare sends to a sequence's waitlist 5 minutes before each opening. | | [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md) |
| Publish freeze | The window from 15 minutes before any distribution opens until it closes, when republishing a hosted page requires **Override freeze and publish**. | | [Brand, templates and designs](https://docs.fanfare.io/concepts/design.md) |
| **Template** | A reusable design stored in **Design Studio**, including page templates, widget designs, message templates, and wallet pass designs. | | [Brand, templates and designs](https://docs.fanfare.io/concepts/design.md) |
| **Widget** | The drop component where customers join, enter, bid, book, or buy—embedded on your own site or inside a hosted page. | | [Brand, templates and designs](https://docs.fanfare.io/concepts/design.md) |

## Plans and billing

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| Billing period | The cycle **Usage** uses to total your Fanfare per-order fees. | | [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) |
| **Past due** | Your last subscription payment failed. You keep your plan's features, and **Update payment method** resolves it (if Shopify bills your plan, update it in Shopify). | | [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) |
| **Starter**, **Growth**, **Pro**, **Enterprise** | Fanfare's four plans, which determine your take rate and which features you can create or edit—never whether existing drops keep running. | | [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md) |
| **Trial** | You're trialing a paid plan until the date shown beside "Trial ends". | | [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) |
| **Usage** | The per-order fees Fanfare collected on your paid orders, totaled by billing period. | | [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) |

## On Shopify

All other terms work the same in both the standalone Fanfare admin and the Shopify app.

| Term | Meaning | API term | Explained in |
| - | - | - | - |
| **Checkout protection** | A Shopify checkout rule that blocks checkout for a protected product unless the customer gained access through your experience. | | [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md) |
| **Manage in Shopify** | Shown disabled on plans in the Fanfare admin when Shopify bills your subscription—change your plan in Shopify instead. | | [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) |
| Shopify checkout | Customers pay directly in Shopify, which owns the order and handles refunds. | | [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md) |
| **Shopify-managed** | Shopify tracks the product's stock count, and only Shopify checkout can sell it. | | [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md) |
| **Source missing** | Flags a product deleted in Shopify. Fanfare keeps the record, but you can't add it to an experience or sequence. | | [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md) |
| **Sync from Shopify** | Pulls a product's latest changes from Shopify into Fanfare immediately. | | [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md) |

## Words you may see elsewhere

These terms appear in admin UI copy or developer docs. This guide uses the term in the last column.

| Word | Where you see it | What this guide calls it |
| - | - | - |
| access window | API docs, for the time to pay after admission | [Payment window](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| consumer | API and SDK docs, and **Bias toward loyal consumers** in the admin | [Customer](https://docs.fanfare.io/concepts/customers.md) |
| drop | **By drop** on **Usage** | [Experience](https://docs.fanfare.io/concepts/experiences.md) |
| grant | SDK docs, for an admitted customer's right to buy | [Admission](https://docs.fanfare.io/concepts/admission-and-payment.md) |
| mechanism | SDK docs, for the type of a distribution | [Distribution](https://docs.fanfare.io/concepts/distributions/overview.md) |
| size | Stock screens, for each variant of a product | [Variant](https://docs.fanfare.io/guide/create/products.md) |


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