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 | |
| Allocation Percentages | In a Mystery Box sequence, each product’s share of random assignments. Separate from stock allocation. | allocation weights | Add and gate sequences |
| Appointment | A distribution for booking time slots instead of buying products. Appointments don’t collect payment. | Appointment | |
| 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 | |
| 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 | |
| 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 | |
| Customer Picks | The default product selection mode, where each customer chooses their own product. | Add and gate sequences | |
| Deactivate | Permanently ends a distribution, sequence, or experience right away. It’s not a pause and can’t be undone. | Stop a drop | |
| 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 | |
| Distribution | How a sequence releases products during a time window—a queue, draw, auction, timed release, or appointment. | mechanism (the type) | Distributions |
| Draw | A distribution that selects winners at random from all entrants, so arriving early gives no advantage. | Draw | |
| Draw at | When a draw runs its first winner selection. Labeled Draw date in the experience wizard and edit dialog. | Draw | |
| Drop | The launch event an experience powers—not a separate object. Appears in admin labels like By drop on Usage. | Experiences | |
| 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 | |
| Experience | The container for a drop, holding its products, time zone, design, announcements, and one or more sequences. | Experiences | |
| Mystery Box | The product selection mode where Fanfare assigns each customer a product at random based on your configured weights. | Add and gate sequences | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| Sequence | One entry path into an experience, with its own access gates, share of stock, distributions, and waitlist. | Sequences and routing | |
| 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 | |
| Status chip | The badge showing the current state of an experience, sequence, distribution, order, or audience. | Status reference | |
| Timed Release | A distribution that opens sales to everyone at a set time with no line. Customers see it titled “Flash Sale”. | Timed release | |
| Waiting room | The 5-minute window before a queue’s Opens time when customers can join, before anyone is admitted. | Queue | |
| 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 | |
| Winner count | How many winners a draw targets. When every variant has a fixed unit count, it can’t exceed those total units. | Draw |
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 |
| Admission expiration | A draw’s payment window, configured in seconds on the draw. | Admission and the payment window | |
| 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 | |
| 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 | |
| Custom rate | A negotiated Fanfare fee that replaces your plan’s standard take rates and carries over if you change plans. | Payments and fees | |
| 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 | |
| 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 | |
| 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 |
| 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 |
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 | |
| Allocated | Units of a variant reserved for your experiences. | Stock | |
| At risk | Units in active checkouts that On hand inventory no longer covers (normally 0). | Stock | |
| Available | Supply minus Allocated—units still free to assign to an experience (negative if over-allocated). | Stock | |
| Counting | Live stock tracking for a sequence, starting about 10 minutes before it opens. Once counting starts, variant allocations can only increase. | Stock | |
| Held: stock | A sequence paused from opening because a variant’s supply fell below its allocation. Clears once supply covers the allocation again. | Stock | |
| In checkout | Units temporarily held by admitted customers while they complete payment. | Stock | |
| 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 | |
| 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 | |
| On hand | Supply minus Sold. | Stock | |
| Opens sold out | Shown on a variant with no units assigned in a sequence. Customers can’t buy it until you allocate units. | Stock | |
| 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 | |
| Released | A sequence that has finished selling. Its unsold units return to the experience, and its stock can no longer change. | Stock | |
| Sold | Units with captured payments. Refunding an order doesn’t reduce this count. | Stock | |
| 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 | |
| Supply | Opening stock plus every receipt, adjustment, write-off, and return recorded since. | Stock | |
| Unassigned | Units allocated to an experience that haven’t been assigned to any sequence yet. | Stock | |
| Variant | One size, color, or other option of a product. Stock screens refer to each variant as a size. | Add products |
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 | |
| 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 | |
| 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 |
| 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 | |
| Invite | The email a sequence sends to its audience members inviting them to enter. | Invites, waitlist and access-code sends | |
| 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 | |
| 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 | |
| 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 |
| 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 | |
| Shared access code | A single code you distribute that customers type to unlock a sequence. Access codes aren’t case-sensitive. | Sequences and routing | |
| Wallet pass | A loyalty pass for Apple Wallet or Google Wallet showing a customer’s points balance. | Loyalty and Fanfair |
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 | |
| Order status | The current state of an order. See Status reference for every value. | Status reference | |
| Payment status | The state of an order’s payment, shown below the order status when it adds detail. | Orders and refunds | |
| 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 | |
| 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 | |
| Test order | An order placed with a test payment method—badged Test and excluded from revenue, purchase limits, and customer metrics. | Orders and refunds |
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 | |
| Brand | Your organization’s logo, colors, and fonts, applied across every experience. Edits reach live pages right away without republishing. | Brand, templates and designs | |
| Design Studio | Where you manage your brand and store reusable templates and widget designs. | Templates and widget designs | |
| 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 | |
| Hosted page | An optional web page Fanfare hosts for an experience at a shareable URL. | Build and publish the hosted page | |
| ”Opens soon” message | The reminder Fanfare sends to a sequence’s waitlist 5 minutes before each opening. | Invites, waitlist and access-code sends | |
| 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 | |
| Template | A reusable design stored in Design Studio, including page templates, widget designs, message templates, and wallet pass designs. | Brand, templates and designs | |
| 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 |
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 | |
| 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 | |
| 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 | |
| Trial | You’re trialing a paid plan until the date shown beside “Trial ends”. | Billing and usage | |
| Usage | The per-order fees Fanfare collected on your paid orders, totaled by billing period. | Billing and usage |
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 | |
| 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 | |
| Shopify checkout | Customers pay directly in Shopify, which owns the order and handles refunds. | Checkout options | |
| Shopify-managed | Shopify tracks the product’s stock count, and only Shopify checkout can sell it. | Products from Shopify | |
| 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 | |
| Sync from Shopify | Pulls a product’s latest changes from Shopify into Fanfare immediately. | Products from Shopify |
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 |
| consumer | API and SDK docs, and Bias toward loyal consumers in the admin | Customer |
| drop | By drop on Usage | Experience |
| grant | SDK docs, for an admitted customer’s right to buy | Admission |
| mechanism | SDK docs, for the type of a distribution | Distribution |
| size | Stock screens, for each variant of a product | Variant |