CLIENT101: App start failed
What this means
WCPOS could not finish starting.
From the till this looks like a blank or stuck screen, or a loading spinner that never clears. It usually means the device's local database could not be opened. Restarting sometimes clears it; if not, the fix is to clear the local database and reopen, and WCPOS re-downloads everything from your store.
Clearing the local database permanently deletes anything on this device that has not yet synced to your store — for example sales taken while offline. Because the app cannot open, these cannot be synced first, so they cannot be recovered. If you know important sales are still unsynced on this device, contact support before clearing.
Your data
Your store's data is safe — it downloads again the next time the app opens. Clearing removes only this device's local copy, including any changes that had not yet reached your store (see the warning above).
Troubleshoot
- Restart the app once; on web, fully reload the tab — a transient startup failure often clears on its own.
- If it still will not start, the local database most likely cannot be opened. Clear it and reopen — follow Clear All Local Data, which covers the in-app button, the web app, and the desktop app. WCPOS re-downloads your store's data automatically. (This deletes unsynced data on this device — see the warning above.)
- If startup still fails after clearing, use Copy debug info — or the browser console error, if the app cannot open its own logs — and contact support.