Skip to main content
Version: 1.x

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. Restart WCPOS (on the web, reload the tab) — a startup failure often clears on its own. If it still won't start, contact support before clearing anything.

Don't clear this device's data

This device may hold sales that haven't reached your store — for example sales taken while offline. While WCPOS can't start, they can't be sent, so clearing local data, signing out or reinstalling would delete them permanently. Contact support before clearing anything.

Your data​

Don't clear this device's data — it may hold changes your store doesn't have yet. Your store's own data is safe and unaffected.

Troubleshoot​

  1. Restart WCPOS once; on the web, fully reload the tab — a transient startup failure often clears on its own.
  2. If it still won't start, contact support before clearing anything. Send Copy debug info from the Logs tab if WCPOS opens far enough to reach it — otherwise the error shown in the browser console (developer tools), or in the desktop app's Advanced → Toggle Developer Tools.
  3. Don't clear local data, sign out or reinstall while you wait — support will tell you whether anything on this device needs recovering first.

Details​

Code
CLIENT101 (APP_START_FAILED)
Severity
error
Introduced in
WCPOS 1.10.0