Cloud Sync tab

The Cloud Sync tab is where you connect the booth to your BoothIQ cloud account, see what's syncing in real time, and manage the link. There's also a Cloud Features card that summarizes what unlocks when you're connected.

If you've never registered the booth, this is also where you do it for the first time.

Who this is for: Operators registering a new booth, monitoring an existing connection, or unregistering for a move.

What this tab is for

  • See the link status at a glance
  • Link the booth by showing a QR code you scan with the BoothIQ app
  • View live Sync Status: pending items, last sync time, total synced
  • Trigger a manual sync
  • See which Cloud Features are available when connected
  • Unregister the booth

Layout

Top to bottom and left to right:

  1. Page header. Title "Cloud Sync", subtitle "Connect your booth to the cloud for remote monitoring and data sync"
  2. Status badge at the top right showing "Connected" / "Not Registered" / etc.
  3. Link This Booth card. Shows the QR code to scan, or a "linked" message once connected
  4. Unregister Booth button. Visible only when linked
  5. Cloud Features card. 3×2 grid of feature tiles
  6. Sync Status card in the right column
Screenshot needed
cloud-sync-tab-full.png
Cloud Sync tab with the status badge, Link This Booth card, Cloud Features grid, and Sync Status card.

Status badge

A pill at the top right of the page. The colors and text mean:

  • Connected (green). The booth is registered and successfully talking to the cloud
  • Not Registered (amber / yellow). The booth has never been registered, or registration was cleared
  • Error (red). The booth was registered but the cloud is unreachable or rejected the credentials

This is the first thing to look at when you open this tab.

The only way to link a kiosk. The card's subtitle reads "Connect this booth to your cloud account".

When the kiosk is not linked, you'll see:

  • A QR code on a white plate. It encodes only the kiosk's hardware identity, never an account or a key
  • A status line: "Waiting for activation...", with the time the code expires
  • A Refresh QR button. Codes expire after 15 minutes; tap this for a new one
  • A How linking works info panel listing the steps:
    1. Open the BoothIQ app and sign in
    2. Tap "Activate Booth" on the subscribed booth
    3. Scan the QR code with your phone
    4. The booth activates automatically once approved
    In the app, Activate booth is under the booth's Settings.

Once linked, the QR code is replaced by "This booth is linked to the cloud. Use Unregister below to link a different booth."

For a step-by-step walkthrough, see Connecting Your Kiosk › Cloud registration.

Screenshot needed
cloud-sync-link-this-booth.png
Link This Booth card showing the QR code, the Waiting for activation status, and the How linking works panel.
No typed codes, no manual form
Earlier software had a Quick Registration code input and a Manual Registration form for Booth ID, API key, and URL. Both were removed. If support asks for the booth's API key, it is in the web dashboard under Settings › Connection Details; it is not used for linking.

Unregister Booth button

A red button labeled Unregister Booth with an X icon. Visible only when the booth is currently registered. Tap it to clear the cloud credentials and stop the sync.

Unregistering does not delete local data. Sales, templates, settings, photos, and credit history are all preserved. You can link again at any time by scanning the fresh QR code the card shows.

Note
Use this when you're moving the booth between cloud accounts, when you're decommissioning a booth, or when support tells you to as part of a recovery procedure.

Cloud Features card

A grid of six tiles showing the features that unlock when you connect to the cloud:

  • Remote Analytics. View booth stats from the cloud dashboard
  • Notifications. Get alerts on your phone when the booth needs attention
  • Template Sync. Push templates to the booth remotely
  • Sales Reports. Financial summaries in the cloud
  • Photo Backup. Cloud photo storage
  • Remote Config. Update settings remotely

This card is informational. It tells you what's possible. Whether each feature actually does something for you depends on whether you've set it up in the cloud dashboard.

Screenshot needed
cloud-sync-features-grid.png
Cloud Features 3x2 grid with six feature tiles.

Sync Status card

In the right column. Subtitle: "Queue and sync info".

Shows:

  • A Sync icon at the top
  • The pending items count. How many transactions or events are queued waiting to sync
  • The last sync time. Timestamp of the most recent successful sync
  • The total items synced. Running lifetime count
  • (Possibly) a Sync Now button to force an immediate sync

Use this card to confirm the cloud sync is healthy:

  • Pending items: 0 and a recent Last sync time = healthy
  • Pending items growing with no recent sync = something is wrong
Screenshot needed
cloud-sync-status-card.png
Sync Status card with pending items count, last sync time, and total synced count.

Verify it worked

You can use the Cloud Sync tab effectively when you can:

  • Link a booth by scanning its QR code from the BoothIQ app
  • Read the status badge and tell whether the booth is connected
  • Read the Sync Status card and tell whether sync is keeping up
  • Find the Unregister Booth button when you need it

Common problems

Status badge stays "Not Registered" after the app said the scan succeeded.

The kiosk picks the result up by polling, so it needs to be online. Check Wi-Fi; it catches up on its own once connected. If the app never confirmed the booth, the scan did not complete: in the app, open the booth → Settings → Activate booth and scan again.

Status badge says "Connected" but pending items are growing.

Network is up but the cloud API is rejecting items. Check the cloud dashboard for billing or rate-limit issues.

Last sync is old.

Recent network outage; sync will catch up. Wait a few minutes; if it doesn't catch up, check Wi-Fi and tap Sync Now in the Sync Status card.

The app says the QR code is invalid or expired.

Codes expire after 15 minutes. Tap Refresh QR on the kiosk and scan the new one.

Booth is linked but I can't see it in the cloud dashboard.

The cloud dashboard may need a refresh. Refresh your browser; if still missing, the link didn't actually succeed, so check the status badge on the kiosk.

Next steps