Customize WooCommerce Product List (woo-list)
To customize the display of WooCommerce products, you can add url parameters to the woo-list component.
On a block page, you can add these in the parameters field.
On a custom HTML page, you can add these in the route attribute:
<woo-list route="products?on_sale=true&orderby=title&type=simple,variable"></woo-list>
All available parameters are listed below.
List all products
Available parameters
| Parameter | Type | Description |
| page | integer | Current page of the collection. |
| per_page | integer | Maximum number of items to be returned in result set. |
| search | string | Limit results to those matching a string. |
| exclude | array | Ensure result set excludes specific IDs. |
| include | array | Limit result set to specific IDs. |
| offset | integer | Offset the result set by a specific number of items. |
| order | string | Order sort attribute ascending or descending. Options: asc and desc. Default is desc. |
| orderby | string | Sort collection by object attribute. Options: date, id, include, title , price, popularity,and slug. Default is date. |
| parent | array | Limit result set to those of particular parent IDs. |
| parent_exclude | array | Limit result set to all items except those of a particular parent ID. |
| type | string | Limit result set to products assigned a specific type. Options: simple, grouped, external and variable. Some plugins add types, such as booking or variable-subscription. |
| sku | string | Limit result set to products with a specific SKU. |
| featured | boolean | Limit result set to featured products. |
| category | string | Limit result set to products assigned a specific category ID. |
| tag | string | Limit result set to products assigned a specific tag ID. |
| shipping_class |
string | Limit result set to products assigned a specific shipping class ID. |
| tax_class | string | Limit result set to products with a specific tax class. Default options: standard, reduced-rate and zero-rate. |
| stock_status | string | Limit result set to products with specified stock status. Options: instock, outofstock and onbackorder. |
| on_sale | boolean | Limit result set to products on sale. |
| visibility | string | Accepts a string: One of 'visible', 'catalog', 'search', or 'hidden'. |
List all product categories
Available parameters
| Parameter | Type | Description |
| page | integer | Current page of the collection. Default is 1. |
| per_page | integer | Maximum number of items to be returned in result set. Default is 10. |
| search | string | Limit results to those matching a string. |
| exclude | array | Ensure result set excludes specific IDs. |
| include | array | Limit result set to specific IDs. |
| order | string | Order sort attribute ascending or descending. Options: asc and desc. Default is asc. |
| orderby | string | Sort collection by resource attribute. Options: id, include, name, slug, term_group, description and count. Default is name. |
| hide_empty | boolean | Whether to hide resources not assigned to any products. Default is false. |
| parent | integer | Limit result set to resources assigned to a specific parent. |
| slug | string | Limit result set to resources with a specific slug. |
| get | string | Whether to return terms regardless of ancestry or whether the terms are empty. Accepts all or empty (disabled). |