SYNC311: Schema mismatch
What this means
The data stored on this device is from a different version of the app and cannot be opened.
The fix is to clear the device's local database and reopen — WCPOS then re-downloads everything from your store. A schema mismatch usually follows an app update or downgrade on this device.
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 database will not 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. Only the device's local copy is cleared, including any changes that had not yet reached your store (see the warning above).
Troubleshoot
- Make sure WCPOS is on the current version on this device — a schema mismatch usually follows a version change.
- Clear the local database 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 the error returns after clearing, use Copy debug info and contact support.