WooCommerce plugin docs / Cart Assistant

Cart Assistant settings

Navigation: WordPress Admin → WooCommerce → AI Assistant → Cart Assistant

Intro: *Read and update the shopper cart. Mutations still require confirmation.*

The in-chat cart uses the WooCommerce session cart. The client cannot set a price. Extra REST body fields are ignored.

Quantity and remove from the mini-cart write the session directly. Add from an AI suggestion is staged and must be confirmed. REST POST /cart/add also stages confirmation through the same broker.


Enable cart reading (get_cart)

What it does Lets the assistant describe the current cart.

Default value On.

Available options On / Off.

Recommended configuration On.

When to use it Off if you do not want the model to see cart line items.

Effect on the frontend Shoppers can ask “what’s in my cart?” Mini-cart UI still uses GET /aiwsa/v1/cart.

Dependencies WooCommerce cart session.

Important notes Cart totals come from WooCommerce.

Example “Do I already have the starter motor in the cart?”


Enable add to cart (add_to_cart)

What it does Stages an add-to-cart action that the shopper must confirm.

Default value On.

Available options On / Off.

Recommended configuration On.

When to use it Off for browse-only assistants.

Effect on the frontend Product cards show Add. Confirm / Cancel appears for AI-staged adds. Widget feature cart follows this tool.

Dependencies Purchasable, in-stock products. Variable products need a variation.

Important notes Product IDs for AI add-to-cart must come from this conversation’s search or recommendation results. Quantity is capped (filter aiwsa_max_add_to_cart_quantity).

Example Assistant proposes adding SKU 412; shopper taps Confirm; WooCommerce cart updates.


Enable quantity updates (update_quantity)

What it does Stages a quantity change that the shopper must confirm (AI path). Mini-cart quantity controls write the session when this tool is enabled (cartUpdate feature flag).

Default value On.

Available options On / Off.

Recommended configuration On.

When to use it Off to lock quantities to WooCommerce cart page only.

Effect on the frontend Mini-cart steppers appear when enabled.

Dependencies Items already in the cart.

Important notes Stock limits still apply.

Example Change quantity from 1 to 2 in the chat cart.


Enable item removal (remove_from_cart)

What it does Stages removing a cart item after confirmation (AI path). Mini-cart remove uses POST /cart/remove when enabled.

Default value On.

Available options On / Off.

Recommended configuration On.

When to use it Off to force shoppers to the WooCommerce cart page to delete lines.

Effect on the frontend Remove control on mini-cart lines.

Dependencies Cart reading / session cart.

Important notes Does not empty the whole cart (see clear cart).

Example Remove a wrongly added accessory.


Enable clear cart (clear_cart)

What it does Stages emptying the cart after confirmation.

Default value On.

Available options On / Off.

Recommended configuration On only if you want “start over” in chat. Off if accidental clears are a support risk.

When to use it Shoppers who build large carts in chat.

Effect on the frontend The model may offer to clear the cart; the shopper must confirm.

Dependencies Confirmation broker.

Important notes Irreversible for that session’s lines (WooCommerce cart emptied).

Example “Clear my cart and start again.”