WooCommerce Catalog & Products
Before writing code
Fetch live docs:
- Web-search
site:developer.woocommerce.com products for product documentation
- Fetch
https://woocommerce.github.io/code-reference/ for class reference
- Web-search
woocommerce custom product type implementation for custom product types
Product Types
Built-In Types
| Type |
Class |
Description |
| Simple |
WC_Product_Simple |
Single product, no options |
| Variable |
WC_Product_Variable |
Product with variations (size, color) |
| Variation |
WC_Product_Variation |
Individual variation of a variable product |
| Grouped |
WC_Product_Grouped |
Collection of related simple products |
| External/Affiliate |
WC_Product_External |
Linked to external URL |
Virtual & Downloadable Flags
Any product can be marked:
- Virtual — no shipping (services, memberships)
- Downloadable — digital delivery (files, licenses)
Custom Product Types
- Extend
WC_Product (or WC_Product_Simple)
- Register the type via
woocommerce_product_type_selector filter
- Register the class via
woocommerce_product_class filter or woocommerce_product_type_{type} class name filter
Product Factory
WC_Product_Factory resolves a product ID to the correct class:
wc_get_product( $id ) — returns the correct WC_Product_* subclass
- Uses
woocommerce_product_class filter to allow custom type resolution
Product CRUD
Creating Products
$product = new WC_Product_Simple();
$product->set_name( 'My Product' );
$product->set_regular_price( '29.99' );
$product->set_status( 'publish' );
$product->save();
Querying Products
wc_get_products( $args ) — primary query method:
type — product type(s)
status — post status
sku — SKU lookup
category — category slug(s)
tag — tag slug(s)
limit, page, offset — pagination
orderby, order — sorting
meta_key, meta_value — meta queries
return — 'objects' (default) or 'ids'
WC_Product_Query
Object-oriented query builder — same as wc_get_products() but chainable.
Categories & Taxonomies
Product Categories
Taxonomy: product_cat (hierarchical)
wp_set_object_terms( $product_id, $term_ids, 'product_cat' )
get_the_terms( $product_id, 'product_cat' )
- Or CRUD:
$product->set_category_ids( [ 12, 15 ] )
Product Tags
Taxonomy: product_tag (non-hierarchical)
$product->set_tag_ids( [ 5, 8 ] )
Product Type
Taxonomy: product_type — internal, determines the product class.
Custom Taxonomies
Register with register_taxonomy() associated with product post type. Set show_in_rest => true for block editor and API support.
Product Visibility
Catalog Visibility
$product->set_catalog_visibility( $visibility ):
visible — shop and search
catalog — shop only
search — search only
hidden — not visible (accessible via direct URL)
Stock Status
$product->set_stock_status( $status ):
instock, outofstock, onbackorder
- Controls visibility when "Hide out of stock" setting is enabled
Product Images
$product->set_image_id( $attachment_id ) — featured image
$product->set_gallery_image_ids( [ $id1, $id2 ] ) — gallery
Variable Products & Variations
Variable Product Setup
- Create
WC_Product_Variable
- Define attributes with
set_attributes() (mark as variation = true)
- Create
WC_Product_Variation for each combination
- Each variation has its own price, SKU, stock, image
Variation Attributes
Each variation specifies attribute values:
$variation->set_attributes( [ 'pa_color' => 'red', 'pa_size' => 'large' ] )
- Empty value = "Any" (matches all)
Related Products & Upsells
$product->set_upsell_ids( $ids ) — upsell products
$product->set_cross_sell_ids( $ids ) — cross-sells (shown in cart)
- Related products auto-calculated from shared categories/tags (filterable via
woocommerce_related_products filter)
Best Practices
- Use
wc_get_product() to load products — never new WC_Product( $id ) directly
- Use
wc_get_products() for queries — not WP_Query with post_type => 'product'
- Use CRUD methods for all property access
- Declare product type support:
show_if_simple, show_if_variable classes on admin tabs
- Cache product data when iterating over large collections
- Use
wc_clean() to sanitize product input data
Fetch the WooCommerce product documentation and code reference for exact method signatures, query parameters, and product type registration patterns before implementing.
1---2name: woo-catalog3description: Work with WooCommerce catalog — product types, categories, tags, attributes, product queries, search, related products, and product visibility. Use when managing products programmatically or customizing the catalog display.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/woo-catalog7---89# WooCommerce Catalog & Products1011## Before writing code1213**Fetch live docs**:141. Web-search `site:developer.woocommerce.com products` for product documentation152. Fetch `https://woocommerce.github.io/code-reference/` for class reference163. Web-search `woocommerce custom product type implementation` for custom product types1718## Product Types1920### Built-In Types2122| Type | Class | Description |23|------|-------|-------------|24| Simple | `WC_Product_Simple` | Single product, no options |25| Variable | `WC_Product_Variable` | Product with variations (size, color) |26| Variation | `WC_Product_Variation` | Individual variation of a variable product |27| Grouped | `WC_Product_Grouped` | Collection of related simple products |28| External/Affiliate | `WC_Product_External` | Linked to external URL |2930### Virtual & Downloadable Flags3132Any product can be marked:33- **Virtual** — no shipping (services, memberships)34- **Downloadable** — digital delivery (files, licenses)3536### Custom Product Types37381. Extend `WC_Product` (or `WC_Product_Simple`)392. Register the type via `woocommerce_product_type_selector` filter403. Register the class via `woocommerce_product_class` filter or `woocommerce_product_type_{type}` class name filter4142## Product Factory4344`WC_Product_Factory` resolves a product ID to the correct class:45- `wc_get_product( $id )` — returns the correct `WC_Product_*` subclass46- Uses `woocommerce_product_class` filter to allow custom type resolution4748## Product CRUD4950### Creating Products5152```php53$product = new WC_Product_Simple();54$product->set_name( 'My Product' );55$product->set_regular_price( '29.99' );56$product->set_status( 'publish' );57$product->save();58```5960### Querying Products6162`wc_get_products( $args )` — primary query method:63- `type` — product type(s)64- `status` — post status65- `sku` — SKU lookup66- `category` — category slug(s)67- `tag` — tag slug(s)68- `limit`, `page`, `offset` — pagination69- `orderby`, `order` — sorting70- `meta_key`, `meta_value` — meta queries71- `return` — `'objects'` (default) or `'ids'`7273### WC_Product_Query7475Object-oriented query builder — same as `wc_get_products()` but chainable.7677## Categories & Taxonomies7879### Product Categories8081Taxonomy: `product_cat` (hierarchical)82- `wp_set_object_terms( $product_id, $term_ids, 'product_cat' )`83- `get_the_terms( $product_id, 'product_cat' )`84- Or CRUD: `$product->set_category_ids( [ 12, 15 ] )`8586### Product Tags8788Taxonomy: `product_tag` (non-hierarchical)89- `$product->set_tag_ids( [ 5, 8 ] )`9091### Product Type9293Taxonomy: `product_type` — internal, determines the product class.9495### Custom Taxonomies9697Register with `register_taxonomy()` associated with `product` post type. Set `show_in_rest => true` for block editor and API support.9899## Product Visibility100101### Catalog Visibility102103`$product->set_catalog_visibility( $visibility )`:104- `visible` — shop and search105- `catalog` — shop only106- `search` — search only107- `hidden` — not visible (accessible via direct URL)108109### Stock Status110111`$product->set_stock_status( $status )`:112- `instock`, `outofstock`, `onbackorder`113- Controls visibility when "Hide out of stock" setting is enabled114115## Product Images116117- `$product->set_image_id( $attachment_id )` — featured image118- `$product->set_gallery_image_ids( [ $id1, $id2 ] )` — gallery119120## Variable Products & Variations121122### Variable Product Setup1231241. Create `WC_Product_Variable`1252. Define attributes with `set_attributes()` (mark as `variation = true`)1263. Create `WC_Product_Variation` for each combination1274. Each variation has its own price, SKU, stock, image128129### Variation Attributes130131Each variation specifies attribute values:132- `$variation->set_attributes( [ 'pa_color' => 'red', 'pa_size' => 'large' ] )`133- Empty value = "Any" (matches all)134135## Related Products & Upsells136137- `$product->set_upsell_ids( $ids )` — upsell products138- `$product->set_cross_sell_ids( $ids )` — cross-sells (shown in cart)139- Related products auto-calculated from shared categories/tags (filterable via `woocommerce_related_products` filter)140141## Best Practices142143- Use `wc_get_product()` to load products — never `new WC_Product( $id )` directly144- Use `wc_get_products()` for queries — not `WP_Query` with `post_type => 'product'`145- Use CRUD methods for all property access146- Declare product type support: `show_if_simple`, `show_if_variable` classes on admin tabs147- Cache product data when iterating over large collections148- Use `wc_clean()` to sanitize product input data149150Fetch the WooCommerce product documentation and code reference for exact method signatures, query parameters, and product type registration patterns before implementing.