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 registration. 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 registration status at a glance
  • Register the booth using a 6-character Quick Registration code
  • (Advanced) Register manually with Booth ID + API Key + Cloud API URL
  • 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. Quick Registration card. Collapsible, holds the 6-character code input
  4. Manual Registration (Advanced) card. Collapsible, holds the URL/ID/Key fields
  5. Unregister Booth button. Visible only when registered
  6. Cloud Features card. 3×2 grid of feature tiles
  7. Sync Status card in the right column
Screenshot needed
cloud-sync-tab-full.png
Cloud Sync tab with the status badge, registration cards, 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.

Quick Registration card

The recommended way to register a booth. Collapsible. Tap the header (with the cloud icon and "Quick Registration" label) to expand or collapse.

When expanded, you'll see:

  • A Registration Code input field. Accepts a 6-character code, automatically uppercases letters
  • Helper text under the field: "Enter a 6-character code to enable registration"
  • A Register Booth button (with a link icon). Disabled until 6 characters are entered
  • A How to get your code info panel below, listing the steps:
    1. Log in to your web or mobile app
    2. Create a new booth OR view an existing booth
    3. Click "Generate Registration Code"
    4. Enter the 6-digit code above

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

Screenshot needed
cloud-sync-quick-registration-card.png
Quick Registration card expanded with the 6-character code input and Register Booth button.

Manual Registration (Advanced) card

Collapsible. Tap the header (with the settings icon and "Manual Registration (Advanced)" label) to expand. Use this only when Quick Registration won't work for you, or when support has given you direct credentials.

When expanded, you'll see three input fields:

  • Cloud API URL. Has a default value (http://127.0.0.1:8000 for development; production URLs are different). Don't change it unless your support contact tells you to.
  • Booth ID. A UUID-style identifier
  • API Key. A secret key. There's an eye icon next to the field to show or hide what you're typing.

And two buttons:

  • Save & Connect (primary teal). Stores the credentials and registers
  • Test Connection (secondary white). Verifies the credentials work without committing them

There's a hint below: "Click Save & Connect to store credentials and test the connection".

Warning
The API Key is a secret. Never share it. If it's been compromised, regenerate it from the cloud dashboard and re-register the booth. The old key will be invalidated.

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 re-register at any time with a new code.

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:

  • Register a booth using a 6-character Quick Registration code
  • 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
  • (Rarely) use Manual Registration as a fallback

Common problems

Status badge stays "Not Registered" after entering a code.

Code expired, was wrong, or already used. Generate a fresh code in the cloud dashboard.

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, run Test Connection in Manual Registration.

Quick Registration helper text says "Enter a 6-character code..." but I entered one.

The field validation is per-character. Make sure it's exactly 6 characters. Re-enter the code carefully.

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

The cloud dashboard may need a refresh. Refresh your browser; if still missing, the registration didn't actually succeed.

Next steps