Skip to main content

Configure Queue Experience

Queue experiences provide first-come, first-served access to products or services. Consumers join the queue and are served in the order they arrive, making this ideal for product launches, limited releases, and high-demand events.

When to Use Queues

Queues are best for:
  • Product launches - New product releases with limited initial inventory
  • Limited editions - Exclusive items with controlled distribution
  • Flash sales - Time-limited offers with high demand
  • Event registrations - First-come access to event tickets

Creating a Queue Experience

  1. Navigate to Experiences > Create Experience
  2. Select Queue from the experience type options
  3. Complete the configuration form
Caption: The queue creation form with all configuration options

Queue-Specific Settings

Queue Behavior

SettingDescriptionDefault
Queue ModeHow consumers progress through the queueFirst-come, first-served
Auto-advanceAutomatically move consumers forwardEnabled
Position DisplayShow consumers their position in lineEnabled

Entry Window

Configure when consumers can join the queue: Caption: Set when consumers can join the queue
FieldRequiredDescription
Entry OpensYesDate/time when consumers can start joining
Entry ClosesNoDate/time when new entries stop (queue can continue processing)

Service Window

Configure when queue processing occurs:
FieldRequiredDescription
Service StartsYesWhen the queue begins serving consumers
Service EndsNoWhen queue processing stops
You can allow entries before service begins. This lets consumers join early while processing starts at a specific time.

Inventory Configuration

Caption: Configure how many consumers can be served
FieldRequiredDescription
Total InventoryYesTotal number of successful completions
Per-Consumer LimitNoMaximum purchases per consumer
Reserve QuantityNoInventory held back for later release

Timeout Settings

Configure how long consumers have to complete their purchase:
FieldDescriptionRecommended
Checkout TimeoutTime allowed to complete purchase after reaching front10-15 minutes
Idle TimeoutTime before inactive consumers are removed30 minutes
Caption: Set timeouts to keep the queue moving

Advanced Queue Options

Position Estimation

Show consumers estimated wait times based on:
  • Current queue length
  • Average processing time
  • Historical data
SettingDescription
Show PositionDisplay queue position to consumers
Show EstimateDisplay estimated wait time
Refresh IntervalHow often to update position info

Fairness Controls

Prevent abuse and ensure fair access:
SettingDescription
One Entry Per ConsumerPrevent duplicate entries
Device FingerprintingDetect multiple entries from same device
Rate LimitingLimit entry attempts per IP

Notifications

Configure when consumers receive updates:
EventNotification
Entry ConfirmedConfirmation of queue entry
Position UpdateRegular position updates (configurable)
Near FrontAlert when approaching front of queue
Your TurnNotification to complete purchase
Checkout ReminderWarning before timeout

Queue States

Queues progress through these states:
Draft → Scheduled → Entry Open → Processing → Completed

                      Paused
StateDescriptionConsumer Experience
DraftNot publishedNot visible
ScheduledPublished, waiting for entry windowSee countdown
Entry OpenAccepting new entriesCan join queue
ProcessingServing consumersActive queue display
PausedTemporarily stopped”Queue paused” message
CompletedFinished”Queue closed” message

Example: Product Launch Queue

Here’s a typical configuration for a product launch:

Scenario

  • Product: Limited edition sneakers
  • Inventory: 500 pairs
  • Launch: Saturday at 10 AM

Configuration

Name: "Air Max 2024 Launch Queue"
Product: Air Max Limited Edition
Audience: All Customers

Schedule:
  Entry Opens: Friday 6 PM (day before)
  Service Starts: Saturday 10 AM
  Entry Closes: Saturday 2 PM

Inventory:
  Total: 500
  Per-Consumer: 1

Timeouts:
  Checkout: 10 minutes
  Idle: 30 minutes

Notifications:
  - Entry confirmed
  - Near front (position < 50)
  - Your turn
Caption: A fully configured product launch queue

Best Practices

Before Launch

  1. Test with small inventory - Create a test queue with 5-10 items
  2. Verify notifications - Ensure email/SMS delivery works
  3. Check audience access - Confirm target audience can see the queue
  4. Set realistic timeouts - Balance urgency with customer experience

During Active Queue

  1. Monitor in real-time - Watch the dashboard for issues
  2. Respond to support requests - Handle consumer questions quickly
  3. Pause if needed - Don’t hesitate to pause if problems arise
  4. Track completion rate - Monitor how many complete vs. timeout

Common Mistakes to Avoid

MistakeProblemSolution
Timeout too shortFrustrated customersAllow at least 10 minutes for checkout
No per-consumer limitResellers grab inventorySet limit of 1-2 per consumer
Entry opens at service timeServer overloadOpen entries early
No notificationsCustomers miss their turnEnable all key notifications

Troubleshooting

High Drop-off Rate

If many consumers are timing out:
  • Increase checkout timeout
  • Simplify the checkout process
  • Send reminder notifications earlier

Queue Moving Slowly

If the queue seems stuck:
  • Check if consumers are completing purchases
  • Verify inventory is available
  • Look for payment processing issues

Suspected Abuse

If you notice suspicious activity:
  • Enable device fingerprinting
  • Review entries for patterns
  • Consider pausing and investigating