Troubleshooting, Compatibility & FAQ for WooCommerce POS
WooCommerce Point of Sale provides robust functionality, but admins and users may occasionally need guidance on troubleshooting, compatibility, and system requirements. This section covers common issues, solutions, and important notes.
Flush Rewrite Rules
To ensure POS store links work correctly, the admin should flush the permalinks by navigating to:
Settings > Permalinks
This updates URL structures and prevents broken links.
Synchronization Issues
- POS agents can synchronize offline store data with the online store whenever they go online
- Sales, customer data, and stock updates are synced to maintain consistency between offline and online stores
Tip: Click the offline sync button in the POS panel to manually synchronize orders if required.
Stock Updates
POS now automatically updates product stock whenever the order status changes, ensuring real-time inventory management.
Compatibility
- Multisite: Fully compatible with WordPress multisite setups
- HPOS: Compatible with WooCommerce’s new High-Performance Order Storage (HPOS)
- Barcodes: Supports Code-128 barcodes for quick product addition
- WPML: Compatible since version 7.1.0. There is no separate settings screen — POS products and categories follow the active WPML language, and the POS login heading, footer brand name and link, and web app name and short name can be translated with WPML String Translation
- ATUM Inventory Management: Compatible since version 7.4.0. No setup is needed. Master stock POS orders leave WooCommerce stock to ATUM, and with centralized inventory the register follows ATUM's out-of-stock threshold. See ATUM Inventory Management
Support Information
- General Support: Contact Webkul Support for queries or suggestions regarding WooCommerce extensions
- Mobile Development: For custom mobile application development, contact [email protected]
- Development Version: A development version of the plugin is available at an additional cost; contact support for details
Direct Printing
Can the POS print without the browser print dialog? Yes. From version 7.3.0, Point of Sale → Settings → Printing connects the POS to an external print service so receipts, drawer reports, barcode labels and PDFs go straight to a thermal, ZPL label or PDF printer. The printers are reached through the print service desktop app on the till computer, so they do not need to be attached to the web server. See Direct Printing.
Why does the browser print dialog still open for some receipts? Receipts and drawer reports go through the print service only when the till's invoice page size is Epson TM-T88V Thermal Page. With any other page size, or when the print service cannot print the job, the browser print dialog opens instead.
Do invoice template fonts apply to direct printing? No. Fonts chosen in the invoice template editor are used only when the receipt is printed through the browser print dialog.
Order Emails
Why do POS order emails arrive a few moments after the sale? From version 7.4.0, order and stock emails for POS orders are sent in the background through WooCommerce's scheduled actions, so the till does not wait for the mail server. If they do not arrive at all, check that scheduled actions are running under WooCommerce → Status → Scheduled Actions.
Current Version Information
- Product Version: 7.4.0
- Supported Frameworks: WordPress 6.5+ (tested up to 7.0), WooCommerce 9.1+ (tested up to 10.9), PHP 7.4+ (tested up to 8.4)
Product Limitations
- Supported Products: Works only with Simple and Variable Products
- Backorders: Not supported, as backorders can complicate POS operations in physical stores where speed and simplicity are critical
System Requirements
- Minimum Screen Resolution: 1280 px (support for 768 px is in progress)
- Compatible Devices: iPads, Tablets, Laptops, Macs, Desktop PCs
- Minimum Screen Size: 7.5 inches
Important Notes
- Offline Sync: Admins can manually sync offline orders using the offline sync button
- Auto Sync: Enable Auto Sync Offline Orders to automatically sync orders whenever a new online order is created
- Version Updates: Updates for Webkul modules can be accessed directly on the Plugins page in WordPress
This ensures your WooCommerce POS system remains up-to-date, fully functional, and optimized for both online and offline operations.
