How-to guide

Activate a booth with the BoothIQ app

Link a kiosk to its booth record by scanning the QR code the kiosk shows. The same scan installs the license, so this is also how a new booth is activated.

Activation and linking are one step. The kiosk shows a QR code that identifies its hardware; you scan it with the BoothIQ app, signed in to the account that owns the booth. The kiosk then receives its license and its cloud credentials together. Nothing is typed into the kiosk, and there is no key to enter.

Before you start

  • A booth record in your account. Create one in the app from the Booths tab, or on the web under Booths with Add booth.
  • Either an active subscription on that booth, or an unused license key issued to the email address you sign in with. Without one of these, the app refuses to activate.
  • The kiosk switched on and connected to the internet. It polls the cloud for your approval.
  • The BoothIQ app on your phone, signed in to the same account, with camera access allowed.

Show the QR code on the kiosk

An unlicensed kiosk shows a pulsing Unlicensed badge in the bottom-right corner of the welcome screen, with Click to activate under it. Tapping the badge opens the QR code. If a customer taps the start circle instead, the kiosk answers "Not Activated" and points at the badge.

On a kiosk that is already licensed, the same QR code is in the admin area under Cloud Sync › Link This Booth.

The code expires after fifteen minutes. If the app says the code has expired, tap Refresh QR on the kiosk and scan again.

Scan it with the app

  1. In the app, select the booth, then open Settings › Booth Management › Activate Booth License.
  2. Choose what to activate with: Use subscription, or one of your license keys listed below it.
  3. Tap Scan Booth QR Code and point the camera at the kiosk's screen.

The app shows "Checking booth…" while it confirms the booth can be activated, then "Activating booth…". When it finishes it shows "Booth Activated!" with the license's end date, or "This license never expires." Tap Done.

On the kiosk, the status line under the QR code changes from "Waiting for activation…" to a "Booth Linked" message, and the badge disappears.

Creating the booth in the app

Right after you create a booth in the app, its confirmation screen offers Scan QR to Activate. That opens the same scanner with the booth already selected.

If the app warns about existing data

The warning appears when the booth record already holds data from different hardware, which happens when a kiosk is replaced.

  • Replace hardware (keep data) moves the record to this kiosk and keeps its sales history.
  • Fresh start (erase) wipes the record's data first. This cannot be undone.

Verify it worked

  • In the admin area, Cloud Sync shows the status "Connected" and the card says the booth is linked.
  • In the app, the booth's card shows a license badge such as "Subscribed" or "Licensed".
  • On the web, the booth's row on the Booths page shows its plan chip and the status dot turns green within a minute of the first heartbeat.

If it does not work

The app saysWhat it meansWhat to do
"QR Code Expired"The fifteen minutes ran out.Tap Refresh QR on the kiosk and scan again.
"Activation Unavailable"The booth has no active subscription and your account has no unused key for it.Subscribe the booth on the web, or ask for a license key.
"Booth Not Ready"The kiosk is not showing the QR screen, or has not reached the cloud yet.Open the QR code on the kiosk and check its internet connection.
"Device Already Bound"This hardware is already linked to another booth record.Unlink it in the admin area first, under Cloud Sync, then scan again.
"Selected License Unavailable"The key you chose was used, expired, or revoked since the list loaded.Go back and choose another key.

Last verified against the software on 2026-10-19.