Skip to main content

How to join a virtual queue (customer view)

This guide covers the flow a customer sees when joining a virtual queue via a QR code or Queue URL

You've created your queue following this guide here - what next?

1. Publishing the queue

Before customers can join, the queue's QR Code or Queue URL needs to be made available to them. A few common ways to do this:

  • In-store display - download the QR code (PNG) and print it to display in the shop window, or print it out and place it on the counter for customers to scan

  • Website - share the Queue URL as a link on the business's website (e.g. a "Join our queue" button)

Both the QR code and Queue URL are found on the queue's detail page.


2. Landing page

When a customer scans the QR code or opens the Queue URL, they land on a welcome screen branded with the business's logo/colours, confirming they've scanned successfully and explaining what joining does for them.

They tap Join the Queue to continue.

(Note: you cannot change the messaging underneath the business name)


3. Entering their details

The customer is asked to fill in their Contact Details:

  • First Name (required)

  • Last Name (required)

  • Email (required)

  • Mobile Number (required)

  • Party Size - +/- stepper defaults to 1 (only shown if Show party size was enabled when the queue was created)

  • CRM fields - you can mark them as optional or required (only shown if you enabled them when the queue was created)

Once complete, they tap Confirm & Join.

(Note: both email and mobile are currently required fields at this time)


4. Confirmation - "You're in line!"

After joining, the customer sees their live queue status:

  • Ticket Number (e.g. Q-001)

  • Position in the queue (e.g. "1st")

  • Est. Wait time

  • Queue Status timeline: Joined Queue → Waiting for Agent → Ready to Serve, each with a timestamp

  • People ahead count

From this screen the customer can also:

  • Delay My Turn - push their position back if they need more time (only show if Allow position delay was enabled when the queue was created)

  • Enable Notifications - opt in to alerts on their browser as their turn approaches

  • Leave Queue - remove themselves from the queue

(Note: currently only browser notifications only work on Android devices and iPhone notifications will impact the exiting Apple notification configuration. We will look at improving this).


5. Delaying their turn

Tapping Delay My Turn opens a "Need more time?" modal. The customer picks a delay of 5, 10, or 15 minutes and taps Confirm (or Cancel to back out).

This delays their turn without losing their spot in the queue entirely.

(Note: these options are not configurable. Only 5, 10, or 15 minute options will display)


6. Leaving the queue

Tapping Leave Queue first prompts a confirmation modal: "Leave the queue?" warning that they'll lose their spot and have to start over if they change their mind. They choose Cancel to stay in the queue, or Yes, Leave to proceed.

After confirming, the customer is asked why they're leaving, with options such as:

  • Wait time was too long

  • Changed my mind

  • Joined by mistake

  • Went to another store

They then tap Confirm Cancellation to leave the queue for good, or Keep my spot to change their mind and stay in the queue.


Quick recap (customer journey)

  1. Business publishes the QR code (shop window/counter) or Queue URL (website)

  2. Customer scans/opens it → Join the Queue

  3. Fill in Contact DetailsConfirm & Join

  4. See live position, ticket number, and estimated wait on the "You're in line!" status page

  5. Optionally Delay My Turn or Enable Notifications

  6. To leave: Leave Queue → confirm → select a reason → Confirm Cancellation (or Keep my spot to stay)

Did this answer your question?