> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wpos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> WooCommerce is the store plugin for WordPress. Connect it to WPOS and the agent can read and manage the store's products, orders, and customers.

WooCommerce is the store plugin for WordPress. Connected to WPOS, the agent can
manage the store's products, orders, customers, and coupons, and pull its sales
reports, all from the chat beside your site's live preview.

**Category:** E-commerce   **Actions available:** 120+

<Note>
  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.
</Note>

## 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](/operate/command-center):

```text theme={null}
List the products that are out of stock.
Show me this week's orders.
Which products sold best this month?
Create a 15% off coupon called SPRING15 that ends on 30 April.
```

## 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](/agencies/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.

<Tabs>
  <Tab title="In the WPOS plugin">
    <Steps>
      <Step title="Open Connectors">
        In WordPress admin, open **WPOS**, click the **+** button to open the
        launcher panel, and choose **Connectors**.
      </Step>

      <Step title="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.
      </Step>

      <Step title="Confirm">
        The WooCommerce row reads **Connected**, and the agent can use the store
        straight away.
      </Step>
    </Steps>
  </Tab>

  <Tab title="From the Workspace">
    <Steps>
      <Step title="Open Connectors at app.wpos.ai">
        In the [Workspace](/agencies/workspace), open **Connectors** and click
        **Connect** on **WooCommerce**. A panel lists every site in your
        account.
      </Step>

      <Step title="Connect a store">
        Click **Connect** next to the store. WPOS asks that site's plugin to
        create its own key, and a message confirms **WooCommerce connected on**
        the site. Your other sites are unaffected.
      </Step>

      <Step title="Repeat for each store">
        Every store has its own key, so connect each one separately. A site
        without WooCommerce installed is skipped.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Paste keys manually instead

Use this only when a site cannot create its own key, for example because its
plugin is too old.

1. In WordPress admin, go to **WooCommerce > Settings > Advanced > REST API**
   and click **Add key**. Give it **Read/Write** permission.
2. In the Workspace, open WooCommerce under **Connectors** and choose **Paste
   keys manually instead**.
3. Paste the **Consumer key** (`ck_…`) and **Consumer secret** (`cs_…`).

<Warning>
  Pasted keys are stored for every site in your account. That is right when you
  run one store, and wrong when your sites are different shops: the agent would
  read the wrong store's data. For separate shops, connect each site on its own.
</Warning>

## 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

<AccordionGroup>
  <Accordion title="&#x22;Handoff mode is on&#x22;">
    The site is in [handoff](/agencies/handoff), which blocks connecting from the
    Workspace. Turn handoff off in the WPOS panel on that site, connect
    WooCommerce, then turn handoff back on.
  </Accordion>

  <Accordion title="&#x22;The WPOS plugin there is too old&#x22;">
    One-click connect needs WPOS plugin v2.2.99 or later. Update the plugin on
    that site, or paste keys manually.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

For popup failures, expired connections, and other issues shared across every
connector, see [Introducing Connectors](/connect/connectors).