choPOS FAQ and troubleshooting
Quick answers, and fixes for the problems people run into most.
Most choPOS problems come from a few settings: browser print margins for receipts, scanner timing for barcodes, per-device settings for tax and currency, and email delivery for receipts. This page answers the common questions and walks through each fix. If you are still stuck, email support@wppres.com.
General questions
What is choPOS?
choPOS is a point of sale plugin for WooCommerce. It adds a till to the WordPress dashboard that sells your WooCommerce products and saves every sale as a WooCommerce order. Read What is choPOS? for an overview.
Is choPOS free?
Yes. choPOS Free is a complete POS for one store with unlimited cashiers and devices. choPOS Pro adds multiple stores, barcode labels, and purchasing and vendors. See Free vs Pro.
Does it need an internet connection?
Yes. The terminal talks to your WordPress site to load products and save orders, so it needs a connection to your site.
Does choPOS take card payments?
choPOS records payments; it does not charge cards. Use any card terminal and record the sale as Card. See Checkout and payments.
Can several cashiers use it at once?
Yes, on any number of devices, each with their own login. See Staff roles.
Will it work with my theme?
Yes. The terminal runs in the WordPress admin and does not use your theme.
Does it support WooCommerce HPOS?
Yes, along with the older posts-based order storage.
Troubleshooting
The barcode scanner does nothing
- Make sure you are on the POS Terminal screen with no window open over it.
- Click an empty part of the screen so no text box has the cursor, then scan again.
- Check Enable Barcode Scanner is on in Settings → Barcode Scanning, and use the Test area there.
- Scan into a text editor on the same device. If nothing appears, the scanner is not connected or paired.
Scans type into the search box
The scanner is typing slower than choPOS expects. Raise Max Time Between Keystrokes to 100 or more. If your scanner does not send Enter after each code, set the character it sends as the Suffix.
“No product matches barcode”
The code is not a product SKU or a choPOS Barcode. Add it to the product’s Barcode field on the Products screen.
Thermal receipts print small or with wide margins
In the browser’s print dialog, set the paper size to 80 mm or 58 mm to match your roll, set margins to none and scale to 100%. If your printer driver has no roll size, add a custom paper size in the driver.
Receipt emails do not arrive
choPOS sends receipts through WordPress’s own email. Many hosts do not deliver it reliably. Install an SMTP plugin and connect it to a mail service, then send a test receipt.
A product is missing from the POS
- Remove the In Stock filter chip; out-of-stock products are hidden by default.
- Check the product is published.
- Search for it by name. The grid loads the first 50 products that match the current filters.
- Click Refresh in the bottom bar to reload products from WooCommerce.
Tax or currency on the till differs from the website
Terminal settings are saved per device. Open Settings → General and Settings → Tax and click Restore Server Settings to copy your WooCommerce settings back. See Taxes.
The camera scanner does not open
Camera scanning needs HTTPS, camera permission for your site, and a browser with a built-in barcode reader, such as Chrome or Edge. Other browsers show a box to type a code instead.
A held cart disappeared
Open carts are kept on the device where they were started. On another device, find the sale on the Orders screen with status POS – Open and choose Re-open.
choPOS Pro features disappeared
Open choPOS → License and read the message there. The usual causes are a changed site address or an expired licence. See Install and activate choPOS Pro.
Get help
Email support@wppres.com with your site address, your WordPress, WooCommerce and choPOS versions, what you expected and what happened, and a screenshot if you can. You can also use the live chat on this site or the WordPress.org support forum. Have an idea? Send a feature request.