Posh
HelpHome

Help center

Cloud sync

Connect once during setup, then sync catalog, sales, and settings across your team's devices.

Last updated: July 17, 2026

Why cloud sync?

Posh works offline-first, but cloud sync gives you backup, multi-device teams, and web orders. During first launch you connect cloud sync once (internet required). After that, the app syncs in the background when online.

  • Same catalog and prices on every device
  • Recover after reinstall or lost tablet with a recovery code
  • Cashiers and inventory staff join with invite codes
  • Sales and settings merge across registers
  • Product images upload to cloud storage when sync is on

What syncs (and what does not)

Synced to cloud

  • Products, categories, variants, prices, and on-hand quantities
  • Sales, orders, customers, and receipts
  • Stock receipts, suppliers, and store settings
  • User profiles and tenant configuration

Device-local only (today)

  • Stock movement ledger (per-item history timeline)
  • Stocktake draft and posted sessions

Managing sync in Settings

Admins open Settings → Cloud sync to:

  • See sync status (connected, last sync time, errors)
  • Run manual sync now
  • Generate invite codes (cashier or inventory staff role)
  • Generate one-time recovery codes for admin device replacement
  • Review sync log for troubleshooting

Cashiers and inventory staff use the Device tab for sync status and manual sync—they cannot generate codes.

First-time connection paths

Create store (admin)

New store setup creates a cloud tenant tied to your store. No codes needed.

Join with invite code

  1. Admin generates invite code in Settings and shares it securely.
  2. New team member chooses Join store during first launch.
  3. Enter invite code on the cloud connection step.
  4. Posh pulls store data and registers the device.

Restore with recovery code

  1. Admin generates recovery code on an existing admin device.
  2. On replacement device, choose Restore during first launch.
  3. Enter recovery code when prompted.
  4. Catalog and settings download from cloud.

Troubleshooting sync

  • Sync failed — check internet, then tap Sync now. Expand the sync log in Settings for error detail.
  • Invite or recovery rejected — codes are single-use and may expire. Generate a fresh code.
  • Device limit reached — POS subscription includes two team devices. See billing or contact support.
  • Stale catalog on cashier tablet — run manual sync on the cashier device after admin edits products.

Security

Sync credentials are configured at app build time—you never type Supabase URLs or keys in the app. Your store is isolated by tenant; invite and recovery codes prove membership without sharing your admin PIN.

Related topics