🔧 Troubleshooting: common fixes

Quick fixes for the most common issues.

Device shows "Unregistered"

• The landing page needs a moment to check in with the server — wait for the 15-second refresh
• Make sure the device ID on the page matches the one registered in Devices
• If it never resolves, ask your admin to verify the device is active and assigned to a store
• Hard-refresh the page (Ctrl+Shift+R) to clear a cached old version

PIN not working

• PINs are 4–6 digits — check you're typing your own, not a device code
• You must be a member of the company the device belongs to
• Ask a company admin to reset it (Companies → Team → Set PIN)
• Offline? The cached user directory might be stale — reconnect once so it refreshes

Printer not printing

• Check the printer is on and connected to the device (USB or network)
• Verify the printer address in Settings → Thermal Receipt Printer
• Use the test button in Settings to confirm the connection
• Receipts are also viewable on screen from the Orders screen

Orders not syncing

• Offline sales sync automatically when the internet returns — give it a minute
• Check Settings → Deployment Readiness for the last-sync time
• Restart the register app if sync seems stuck

Locked features

If Devices, Stores, offline mode, or Deployment Readiness look locked, your company's POS plan is Free or Starter. Upgrade to Business+ from Account → Subscription.