WooCommerce is a first-party WPOS connector. It connects straight to the store
on your own site with a WooCommerce REST API key, and WPOS creates that key for
you. Each store keeps its own key.
What you can do
- Products: list, create, update, duplicate, and delete products, manage their variations, and update stock
- Catalog: manage categories, tags, brands, and product attributes with their terms
- Orders: look up, create, and update orders, add order notes, and record refunds
- Customers: look up, create, and update customers, and see their downloads
- Coupons and reviews: create and manage coupons, and moderate product reviews
- Shipping and tax: manage shipping zones, methods, and classes, and tax rates and classes
- Reports: sales, revenue, and order stats, top sellers, and stock, customer, coupon, and tax reports
- Store setup: read and change store settings and payment gateways, manage webhooks, and check system status
Example requests
Once WooCommerce is connected, ask in the Command Center:Before you connect
- WooCommerce installed and active on the site.
- WPOS plugin v2.2.99 or later for one-click connect. On an older plugin, update it or paste keys manually (see below).
- Handoff mode off on that site if you connect from the Workspace. A site in handoff refuses the connect until handoff is turned off.
Connect it
There are two ways to connect, and both end with the same result: a WooCommerce REST API key (read/write) that WPOS creates on the store itself, so there is nothing to copy.- In the WPOS plugin
- From the Workspace
1
Open Connectors
In WordPress admin, open WPOS, click the + button to open the
launcher panel, and choose Connectors.
2
Connect WooCommerce
Find WooCommerce in the list and connect it. WPOS generates a
WooCommerce REST API key on the site, owned by your admin account, and
checks it against the store.
3
Confirm
The WooCommerce row reads Connected, and the agent can use the store
straight away.
Paste keys manually instead
Use this only when a site cannot create its own key, for example because its plugin is too old.- In WordPress admin, go to WooCommerce > Settings > Advanced > REST API and click Add key. Give it Read/Write permission.
- In the Workspace, open WooCommerce under Connectors and choose Paste keys manually instead.
- Paste the Consumer key (
ck_…) and Consumer secret (cs_…).
Disconnect
- In the WPOS plugin: disconnecting removes the WPOS key from the store’s WooCommerce > Settings > Advanced > REST API list, so old keys do not pile up.
- From the Workspace: Disconnect next to a site deletes that store’s keys only. Disconnect all clears the credential on your account and on every site.
Troubleshooting
"Handoff mode is on"
"Handoff mode is on"
The site is in handoff, which blocks connecting from the
Workspace. Turn handoff off in the WPOS panel on that site, connect
WooCommerce, then turn handoff back on.
"The WPOS plugin there is too old"
"The WPOS plugin there is too old"
One-click connect needs WPOS plugin v2.2.99 or later. Update the plugin on
that site, or paste keys manually.
A site is missing or was skipped
A site is missing or was skipped
The site does not have WooCommerce installed and active, or it is not an
active site in your account. Install and activate WooCommerce, then connect
again.
The agent shows another store's products or orders
The agent shows another store's products or orders
Keys were pasted manually, so every site in the account shares one store’s
credentials. Disconnect, then connect each store from its own site.