Troubleshooting & FAQ
Troubleshooting overview
Quick checks Open Health & Status and fix any failed checks. Confirm WooCommerce is...
POS won’t load / blank screen
Causes & fixes Not logged in — Log in to WordPress first, then open...
Login & permission errors
Ensure user role includes use_pos for POS and posoria_access for admin. Assign via Cashiers...
Barcode not found
Verify barcode is set on the WooCommerce product or variation Ensure scanner sends Enter...
Offline sync issues
Pro Do not use private/incognito mode — IndexedDB required Ensure service worker registered (HTTPS...
Card terminal connection issues
Pro Verify test vs live keys match your reader environment Run connection test in...
WooCommerce / HPOS compatibility
POSORIA declares HPOS (High-Performance Order Storage) compatibility with WooCommerce. If orders fail to create,...
Uninstall & data cleanup
Deactivate and delete Deactivate POSORIA under Plugins. Delete the plugin if you no longer...
Contact support
Before contacting support Check Troubleshooting overview Note your POSORIA version (Lite or Pro) from...