Skip to content
Agent to Bricks

WooCommerce commands

The bricks woo commands expose WooCommerce discovery data in a machine-readable way. They are read-only commands designed for agent prompts, autocomplete flows, and preflight checks before building product grids or query-driven Bricks sections.

Check WooCommerce status

Section titled “Check WooCommerce status”
Terminal window
bricks woo status
bricks woo status --format json
Active:             true
Version:            9.8.1
HPOS:               true
Product post type:  true
Product categories: true
Product tags:       true
Woo element types:  3
Element types:      product-add-to-cart, woocommerce-notice, woocommerce-account-page

Use this before attempting Woo-specific prompts or templates. It tells you whether WooCommerce is active, whether the product taxonomies exist, and whether the current Bricks install exposes Woo-specific element types.

List products

Section titled “List products”
Terminal window
bricks woo products --search hoodie --limit 10
bricks woo products --format json

Flags

Section titled “Flags”
FlagDescription
--search <text>Filter products by title
--limit <N>Maximum results to return
--page <N>Page number for paginated results
--format jsonOutput result as JSON
--jsonShorthand for --format json

Example

Section titled “Example”
Terminal window
bricks woo products --search hoodie
ID    TITLE            SKU         PRICE   STATUS
812   Zip Hoodie       HOOD-ZIP    69.00   publish
844   Pullover Hoodie  HOOD-PULL   59.00   publish

The JSON output includes category and tag summaries for each product, which makes it useful for agent @mentions and product-query planning.

List product categories

Section titled “List product categories”
Terminal window
bricks woo categories
bricks woo categories --search featured --format json
ID   NAME       SLUG       COUNT
21   Featured   featured   14
33   Hoodies    hoodies    8

List product tags

Section titled “List product tags”
Terminal window
bricks woo tags
bricks woo tags --search sale --format json
ID   NAME   SLUG   COUNT
18   Sale   sale   6
27   New    new    9
Section titled “Related commands”