WooCommerce POS Changelog
The latest published releases of WCPOS, the free WooCommerce POS plugin, with their release notes from GitHub.
2.0.5LatestNov 21, 2026
Lets a manager reassign a sale to another cashier, and fixes guest payments on WooCommerce 11.3.1, several push and sign-in failures, and sync tables that go missing. Action may be needed: see Upgrade and compatibility.
Upgrade and compatibility
- Custom receipt templates: a returned line's
qtyis now negative andtotal_qtyis the net count; templates that assume a positiveqtymust handle the sign. (#2684) - Extensions that store visible order-level meta (custom order fields): a push now writes the till's value for any visible order-level key not in
wcpos_sync_order_revision_meta_keysinstead of refusing on conflict; existing hidden keys off the list are still never overwritten. To keep a visible key conflict-checked, add it to that filter, which at order level now lists every hashed key, visible or hidden (in 2.0.3 it listed hidden keys only). (#2713)
Added
- Users with
reassign_woocommerce_pos_salescan set_pos_useron a pushed order to another existing POS user; other_pos_uservalues are still ignored. (#2719) - A cashier or store change on an order with a sale record, from a push or the WP Admin cashier select, appends a reattribution fiscal record (who, when, from, to,
corrects_record_id). If the record cannot be written, the change is not applied and an order note says so. (#2719) - Opt-in fatal-error events sent to WCPOS's error reporting carry the request kind, its REST route and a path with token-like segments masked. (#2700)
Fixed
- Guest-order payments on the pay page work again on WooCommerce 11.3.1, whose new order-pay email check dropped them once the order was more than 10 minutes old. After WCPOS authenticates the request (order key and cashier JWT),
woocommerce_order_email_verification_requiredreturns false for that order in theorder-paycontext only. (#2698) - POS customer creates forwarded to
wc/v3/customersget a generated username and password, so they no longer fail with "Missing parameter(s): username" when the store does not generate them. (#2704) - A re-pushed
pos-discountline that drops its intent keeps the stored quick discount instead of failing with "pos-discount does not exist"; an edited or deleted quick discount inherits nothing. (#2703) - Pushes no longer 409 on every attempt when another plugin serves order meta whose value changes on read (one served an unsaved row holding the clock, so no order could check out). (#2713)
- A sync table (journal, stored digest, mutations) dropped after install is re-created under the DB upgrade lock, instead of every gated sync request answering 503
wcpos_sync_unavailable. When a table cannot be created, its name and the database error are logged. (#2712, #2711) - A surviving journal keeps its epoch and watermarks during that repair, so clients do not resync; only a missing journal starts a new epoch. (#2712)
- Session-row writes are compare-and-swap, so overlapping sign-ins and sign-outs of one user no longer lose a sign-in or bring back a signed-out session. (#2656)
- Receipt data keeps a returned line's signed quantity and unit price instead of 0 at 0.00, and the fiscal sale snapshot stores the signed quantity; returned lines carry no savings and saved totals are clamped at 0. (#2684)
- POS Only hooks return early on non-product queries and skip a redundant re-check. (#2699)
Developer and contract changes
- The order revision recipe changes: order-level meta is hashed only for the keys that filter lists (see Upgrade and compatibility), and a meta row served with a numeric non-positive id is outside the hash on orders and lines (its echo in a push is dropped, not stored). Line meta hashing is otherwise unchanged. Revision hashes change for orders carrying such meta. (#2713)
- A sign-in whose session row cannot be stored answers 503
woocommerce_pos_auth_session_not_storedinstead of a token pair the next request refuses as revoked. New error code on sign-in. (#2656) - The payment-methods envelope adds
default_method, the admin's default gateway, so the app can preselect it. Contract stays 1.3; older apps ignore it. Additive. (#2681) - The status route advertises
order_cashier_reassignment. Additive. (#2719) - New filter
wcpos_error_reporting_request_contextturns off the request context on fatal-error events. Additive. (#2700)
Maintenance
- Bundled Sentry PHP SDK 4.37.1, with
guzzlehttp/psr7held at 3.2.0 until the scoped build handles itstrigger_deprecation()call (tracked in issue #2678). (#2697, #2671) - Translation version pinned to 2026.11.21. (#2682, #2683)
Full diff: https://github.com/wcpos/woocommerce-pos/compare/v2.0.4...v2.0.5
2.0.4Nov 17, 2026
- Receipts print each item's tax with the name and rate the order was charged, so reprinting an older order after a tax rate was renamed (WooCommerce Tax does this) no longer shows the new name and percent against the old amount.
- The orange "Important" upgrade notice on the Plugins screen shows as formatted text instead of raw HTML tags.
- Developers: an order push refused as a conflict (409) now lists in
differsthe fields that differ (names only, never values); sync digest failures are logged under one fixed message, so they group as one error report; translations pinned to 2026.11.18.
2.0.3Nov 14, 2026
- Sales no longer fail with "Checkout failed" when another plugin keeps updating its own hidden data on an order, and a till no longer writes an older copy of that data back.
- Online shop pages on stores with tens of thousands of POS Only products load about twice as fast: each product list carries the POS Only list once, not twice.
- Developers: two new filters for the order revision:
wcpos_sync_order_revision_excluded_meta_keysleaves keys out of it, andwcpos_sync_order_revision_meta_keyslists the hidden keys kept in it.
2.0.2Nov 12, 2026
- Shops with many POS Only products load faster: the POS Only lists are read once per page, not once for every product shown.
- The daily file check no longer reports a healthy install as modified when an update lands while the old code is still running.
2.0.1Nov 10, 2026
- POS Cash and Card take payments again on stores where another plugin loads WooCommerce's payment gateways early (PAYMENT999 "Payment method not found").
2.0.0Nov 9, 2026
WCPOS 2.0 is a major update: an entirely new interface and many new features, and cashiers will need time to get used to it. Update when you have time to learn the new interface, not during a busy shift. What's new: https://docs.wcpos.com/getting-started/whats-new
Sync every till before upgrading: 2.0 starts a new local database and does not carry over unsent 1.11 sales. Rolling back to 1.11 also starts from an empty local database, so sync before you roll back too. The app and the plugin must both be on 2.0; a 1.11 app asks for an update when it meets a 2.0 plugin. WCPOS 2.0 needs WooCommerce 9.0 or later.
WCPOS 2.0 gives the POS its own checkout: cash, split payments and card readers handled at the register itself, with a cash drawer that opens and closes with each shift. Every screen is redrawn, and the till keeps taking cash when the connection drops.
- A checkout that belongs to the POS. Checkout opens in a tender pane beside the cart instead of sending every sale through WooCommerce's order-pay page. Cash is taken at the till, so it lands in the register's count; card and the other manual gateways keep the Legacy tab.
- Split payments. Take one order in several payments, for example part cash and part card, each recorded as it is taken.
- Card readers connected straight to the POS (Pro). Stripe Terminal and SumUp readers pair with the till over Bluetooth; Tap to Pay on iPhone and Android follows in an app update.
- Registers and cash drawer sessions. Opening float, cash in and out, a count at close and the difference against what was expected; set up in POS > Settings > General > Register. Free includes one register; more registers need Pro.
- Closures are saved, numbered documents you can reprint, recount and export as CSV from POS Settings.
- Cash sales keep going when the connection drops.
- A new Reports screen with a comparison period, a chart and cards for orders, products, taxes, refunds, payments, categories and cashiers.
- A customer-facing display (Pro). Open the display page on any device's browser and pair it to a till with a code.
- A redesigned POS with a Scale setting for compact, regular or spacious layouts, and a Fonts setting under Settings > Theme.
- POS Only products are hidden from your online shop. Marking a product POS Only sets its catalog visibility to Hidden; existing POS Only products are updated once at upgrade.
- The POS loads from cdn.wcpos.com, with jsDelivr as the fallback. The bundle is signed and checked before it runs.
- The template gallery has Receipts, Reports, Closures, Display and Email tabs, and receipt fonts download on demand.
- The cashier who opened a session cannot approve its own variance, and the Access screen can restore the default capabilities.
- The experimental magnetic card reader is removed. Card terminal extensions (Stripe, SumUp and the others) need WCPOS Pro from 2.0.
- Developers: sync protocol 3; every plugin hook is now named
wcpos_*(thewoocommerce_pos_*names still fire as deprecated aliases); the 1.x compatibility shims are removed; translations pinned to 2026.11.14; the vendored SQLite worker matches web-bundle v2.0.17.
Since beta 3, for testers on the 2.0 beta:
- A sale, refund or payment change saved while a register is closing is never lost from the books. It lands in the closure or in a correction to it; before, one that arrived mid-close could land in neither.
- Large register sessions no longer run out of memory. A session with thousands of sales could fail its X-report and expected figures on PHP's memory limit; the session's orders are now read one at a time.
- The order-pay page shows the order's own currency symbol on the Cash and Card fields and formats amounts with the POS store's money format.
- Refund receipts add up (Pro). When part of a refund is not tied to a payment, the remainder now prints as cash, so the receipt total matches the amount refunded.
- Beta 3's notes said translations were pinned to 2026.11.12; beta 3 shipped pinned to 2026.11.13.
1.11.10Nov 7, 2026
- A store running a plugin that returns nothing from WordPress's REST dispatch filter syncs its whole catalogue again. WP Activity Log's Redirection sensor does this; the POS asked for every product id, got one page of ten, and silently never finished syncing.
- PDF receipts cap images at 128 MB on every host. The limit used to follow the host's memory_limit, so the same receipt image rendered on one host and showed a broken-image placeholder on another.
- Stripe's card form shows on the POS payment page with WooCommerce Stripe 11.1.1 or later. On older Stripe versions the script stays off the page, because it blocks every other payment method there.
- A guest sale can be paid by card through WooCommerce Stripe. It used to fail with "Missing required customer field: email", so the cashier had to attach a customer first.
- A sale with two coupons on a line whose price includes tax now totals exactly as WooCommerce does.
- The legacy PHP receipt's Total includes tax on stores that display prices excluding tax. It used to print the pre-tax amount.
- Reloading the POS no longer raises an "unknown tax rate" warning before the store's tax rates have been read.
- A sale with a miscellaneous product no longer crashes on stores running MyParcel 6.x.
- A store that is slow to answer when connecting is no longer reported as blocking WCPOS.
- A 1.11 till that meets a store already on WCPOS 2.0 is told to sync before updating, with a link to the upgrade guide.
- Developers: the app's translations come from the 2026.11.1-card tag.
1.11.9Nov 1, 2026
- Fixed POS sales saving with no tax on stores that calculate tax by the customer shipping address -- a regression in 1.11.8. A sale with no shipping address is taxed at the customer billing address, else at the shop base address, as WooCommerce does; the till showed the right tax all along. Orders saved by 1.11.8 with no tax are corrected with Recalculate on the order's edit screen.
- PHP 8.5 no longer logs a deprecation notice on every POS request from the bundled login-token library.
- Developers: the bundled Sentry error-reporting library is updated to 4.34.0.
1.11.8Nov 1, 2026
- New sales start from WooCommerce's own "Calculate tax based on" setting (shop base address, customer billing address or customer shipping address) instead of always the shop base address. A sale with no customer address is still taxed at the shop base address, as in WooCommerce.
- The Extensions screen and its menu badge no longer announce an extension update that needs a newer WCPOS than this site runs.
- The refund window is titled with the order number, not the order's database id.
- Developers: translations updated to 2026.11.0.
1.11.7Oct 28, 2026
- Reading an order from the POS no longer saves it on stores using WooCommerce's High-Performance Order Storage. The first read of a web or admin order could attribute it to the cashier who opened it and make the till's next change to that order fail as out of date.
- A line added to a sale that already has a coupon re-applies the coupon, so the coupon's discount matches the order total (a 10% coupon on a $50 sale stayed at 5.00 after a second $50 line).
- A receipt printed for an order that still needs payment no longer shows a "PAID" row; the Invoice template shows "Amount due" instead. The bundled Detailed Receipt template is updated.
- Variations load correctly on WooCommerce 11.3. A change in how WooCommerce 11.3 applies its on-sale filter dropped variations from the POS's catalogue read, and the till treated them as removed.
- A sale is no longer marked paid when the store's payment check answers with an order that has no status. The pay page's fallback check now waits for a real order status.
- A receipt opened from the device's own data for an order that still needs payment no longer prints a "PAID" row. Offline, or before the store's receipt data arrives, a pending or open order printed "PAID" and the Invoice template hid its "Amount due".
- The loading screen's progress bar is readable on a device in dark mode.
- Developers: the translation template (POT) is updated; Electron desktop runtime 43.8.1.