What are the system requirements for WooCommerce POS?

WooCommerce POS 7.2.0 requires WordPress 6.5 or higher, WooCommerce 9.1 or higher, and PHP 7.4 or higher. The register needs a device with a modern browser, a screen of at least 7.5 inches, and 1280 px display width.

Does WooCommerce POS work offline?

Yes. With Master Stock inventory, the register keeps selling while the internet is down and syncs orders back to WooCommerce with the offline sync button or automatic sync. Coupons and customer account changes need an online connection.

Which product types does WooCommerce POS support?

The register works with Simple and Variable products. Backorders are not supported at the POS.

Why do my POS pages show a 404 error?

Flush the WordPress permalinks from Settings > Permalinks by clicking Save Changes. This rebuilds the URL rules the POS routes depend on.

WooCommerce POS Help Center

Search the documentation, jump to a task, or browse help topics — everything you need to set up, run, and fix your point of sale.

What Are You Trying to Do?

Set up POS for the first time Open the register and start selling Take a payment Handle a refund or return Close the register for the day Connect a receipt printer Sync offline orders Fix an error message

I Need Help As…

A Store Owner or Admin

Install, configure, and manage the POS from WordPress.

An Outlet Manager or Cashier

Run the register and serve customers day to day.

A Technical or Integration User

Connect hardware, integrations, and diagnose issues.

Browse Help Topics

Getting StartedWhat WooCommerce POS is and how it fits your store.Installation and ActivationInstall the plugin, run the wizard, activate the license.POS ConfigurationCron, orders, barcodes, payments, printers, appearance.Outlets and RegistersCreate outlets and assign products and cashiers.Products and InventoryMaster stock, product assignment, and stock rules.Orders and CheckoutCarts, customers, checkout, and order management.Payments and RefundsPayment methods, split payments, and refunds.CustomersAdd walk-in customers and manage their details.Discounts, Coupons and FeesPrice adjustments and coupon rules at checkout.Receipts and Thermal PrintingPrinter types, auto-print, and receipt settings.Barcode ScanningGenerate barcodes and scan products at checkout.Cash Drawer ManagementOpening floats, transactions, and close counter.Reports and AnalyticsSales by date, product, category, and customer.Z-Reports and Register ClosingEnd-of-shift reconciliation and printed reports.Offline Mode and SyncKeep selling offline and sync orders back online.POS Users and PermissionsCreate cashier accounts and assign outlets.Hardware CompatibilityDevices, scanners, printers, and cash drawers.Add-ons and IntegrationsStripe, Square, PayPal, and Linkly terminals.Desktop and Mobile AppsPWA apps for desktop, tablet, and mobile.Video TutorialsWatch the POS setup and register in action.FAQsQuick answers to the most common questions.TroubleshootingError messages, fixes, and diagnostic steps.Release NotesWhat is new in the latest POS releases.

Requirements and Compatibility

Current release: WooCommerce POS 7.2.0.

Requirement	Supported
WordPress	6.5 or higher (tested up to 7.0)
WooCommerce	9.1 or higher (tested up to 10.9)
PHP	7.4 or higher (tested up to 8.4)
Display	1280 px width or above, minimum 7.5-inch screen
Devices	Desktop PCs, laptops, Macs, iPads, and tablets with a modern browser
Order storage	Compatible with WooCommerce HPOS and WordPress multisite

See the full system requirements and installation prerequisites.

Hardware at a Glance

Hardware	What Works
Barcode scanners	Code-128 barcodes generated from Product ID or SKU; lookup by SKU, GTIN, UPC, EAN, and ISBN
Receipt printers	A3, A4, A5, and A6 printers plus the Epson TM-T88V thermal printer, with optional auto-print
Cash drawers	Drawer popup with opening-amount prompt at session start
Payment terminals	Stripe, Square, PayPal, and Linkly terminal add-ons, including the Stripe Reader M2
Apps	Progressive Web App installs for desktop, tablet, and mobile

Full details and setup steps are in Hardware Support and Payment Terminal Integrations.

New in Recent Releases

Checkout FeesAdd a percentage or fixed fee at checkout.Checkout Discounts and CouponsCoupon restrictions now apply at the register.Cart Totals and Item EditingCollapsible totals and a Submit button for edits.Improved Drawer ReportsRedesigned report history with date filters.

Video Tutorials

Quick Initial Setup — install the plugin and configure your first outlet and register.

POS System Overview — a tour of the WooCommerce POS register in action.

Frequently Asked Questions

What are the system requirements?

WooCommerce POS 7.2.0 needs WordPress 6.5+, WooCommerce 9.1+, and PHP 7.4+. The register runs in a modern browser on a device with at least a 7.5-inch screen and 1280 px display width. See system requirements.

Does the POS work offline?

Yes. With Master Stock inventory, the register keeps selling while the connection is down, and orders sync back with the offline sync button or the Auto Sync setting. Coupons and customer account changes need an online connection. See offline orders.

Which product types are supported?

Simple and Variable products. Backorders are not supported at the register. See product limitations.

Why do POS pages return a 404 error?

Flush the permalinks: go to Settings → Permalinks in WordPress admin and click Save Changes. This rebuilds the URL rules the POS routes depend on. See troubleshooting.

How do I close the register at the end of the day?

Use Cashier → Close Counter to reconcile the drawer, then generate and print the Z-Report for the shift. See Z-Report generation and printing.

Is the POS compatible with HPOS and multisite?

Yes — WooCommerce High-Performance Order Storage and WordPress multisite are both supported. See compatibility notes.

How do I update the plugin?

Updates for Webkul modules appear on the WordPress Plugins page once your license is active. See license activation.

How do refunds and returns work at the POS?

Cashiers manage returns from the register, and refund details for online orders are also visible at the POS. See managing returns.

Known Limitations and Workarounds

Limitation	Workaround
Only Simple and Variable products are supported	Keep POS catalogs to these product types; other types stay available in the online store
Backorders are not supported at the register	Manage backorder sales through the WooCommerce online checkout
Coupons cannot be applied in offline mode	Apply a manual discount offline, or reconnect before applying the coupon
Customers cannot be added or edited in offline mode	Complete the sale with the default customer and update customer details once online
Centralized Stock inventory cannot process offline orders	Use Master Stock inventory for outlets that need offline selling
Screens narrower than 1280 px are not fully supported yet	Use a device that meets the minimum display width; 768 px support is in progress

Search Tips

The documentation uses some terms interchangeably with everyday store language — searching either form works better with these guides in mind:

If you call it…	The docs call it…
Cashier, sales agent	POS agent, POS user
Store, branch, location	Outlet
Register session, till session	Cash drawer session
Receipt printer	Invoice printer, thermal printer
Card reader, card machine	Payment terminal
Return	Refund, return
Stock	Inventory, Master Stock

If a search returns nothing, try the FAQ, the Troubleshooting index, or browse the topics above.

Still Need Help?

Talk to the Webkul team

If you purchased the plugin and the guides above did not solve your problem, our support team is ready to help. Reading the pre-ticket checklist first usually gets you a faster answer.

Before you open a ticket Submit a ticket Email support

Support portal: webkul.uvdesk.com · Email: [email protected]