Shop Filters displays classic WooCommerce filter widgets for a shop/archive listing. Its filters use the product archive context. WooCommerce must be installed and active.
- Click Add, choose Shop Filters, and place it in the container.
- Under Content > Filters > Widgets, use Add Filter.
- Choose Widget: Active Filters, Price Filter, Rating Filter, or Filter By Attribute.
- Configure the chosen widget's options. Attribute filters include Attribute, Display Type, and Query Type.
- Style Chips, Typography, Price Filter, Rating Filter, Attribute Filter, and Spacing.
- Save your changes.
This element has no children; use its own controls.
Controls
Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. Linked controls have their own reference. In conditions, = means “is” and ≠ means “is not.”
Content > Filters
| Setting |
Purpose and options |
Behavior |
| Widgets |
Add, edit, remove, and reorder widgets. |
Shared |
| Widgets > Widget |
Active Filters, Price Filter, Rating Filter, Filter By Attribute. |
Shared |
| Widgets > Active Filters Options > Title |
Item title. When: Widget = Active Filters. |
Shared |
| Widgets > Price Filter Options > Title |
Item title. When: Widget = Price Filter. |
Shared |
| Widgets > Rating Filter Options > Title |
Item title. When: Widget = Rating Filter. |
Shared |
Shown when Widget = Filter By Attribute.
| Setting |
Purpose and options |
Behavior |
| Widgets > Filter By Attribute Options > Title |
Item title. |
Shared |
| Widgets > Filter By Attribute Options > Attribute |
Choose an available attribute from the list. |
Shared |
| Widgets > Filter By Attribute Options > Display Type |
list, dropdown. |
Shared |
| Widgets > Filter By Attribute Options > Query Type |
and, or. |
Shared |
Design > Chips
| Setting |
Purpose and options |
Behavior |
| Background |
Color or supported fill. |
Hover |
| Padding |
spacing controls. |
See linked controls |
| Typography |
typography controls. |
See linked controls |
| Borders |
borders controls. |
See linked controls |
| Hover Border |
Color or supported fill. |
Shared |
| Hover Shadow |
Shadow offset, blur, spread, color. |
Shared |
| Space Between |
Space between and unit. |
Responsive |
Design > Typography
Design > Price Filter
| Setting |
Purpose and options |
Behavior |
| Bar > Background |
Color or supported fill. |
Shared |
| Bar > Selection |
Color or supported fill. |
Shared |
| Bar > Height |
Height. |
Responsive |
| Bar > Handle > Size |
Size and unit. |
Responsive |
| Bar > Handle > Background |
Color or supported fill. |
Shared |
| Bar > Handle > Borders |
borders controls. |
See linked controls |
| Bar > Handle > Hover Border |
Color or supported fill. |
Shared |
| Bar > Handle > Hover Shadow |
Shadow offset, blur, spread, color. |
Shared |
| Button > Size > Size |
Custom, Small, Default, Large. |
Responsive |
| Button > Size > Padding |
Padding. When: Size = Custom. |
Responsive |
| Button > Size > Override Width |
Override width and unit. |
Shared |
| Button > Size > Full Width At |
Breakpoint. |
Shared |
| Button > Background |
Color or supported fill. |
Hover |
| Button > Outline |
On/off. |
Shared |
Shown when Outline is set.
| Setting |
Purpose and options |
Behavior |
| Button > Color |
Color or supported fill. |
Hover |
| Button > Width |
Width. |
Shared |
| Button > No Fill On Hover |
On/off. |
Shared |
| Setting |
Purpose and options |
Behavior |
| Button > Typography |
typography controls. |
See linked controls |
| Button > Corners |
Square, Round, Custom. |
Shared |
| Button > Corner Radius |
Corner radius and unit. When: Corners = Custom. |
Responsive |
| Button > Effects > Transition Duration |
Transition duration. |
Responsive |
| Button > Effects > Scale On Hover |
Set scale on hover. Range: 0–3. |
Responsive |
| Button > Effects > Shadow |
Shadow offset, blur, spread, color. |
Responsive, Hover |
| Button > Icon > Icon |
Icon. |
Shared |
| Button > Icon > Position |
Before, After. |
Shared |
| Button > Icon > Size |
Size and unit. |
Responsive |
| Button > Icon > Color |
Color or supported fill. |
Hover |
| Button > Icon > Space Before |
Space before and unit. |
Responsive |
| Button > Icon > Space After |
Space after and unit. |
Responsive |
| Button > Icon > Hover Transform |
Hover transform and unit. |
Shared |
| Label |
typography controls. |
See linked controls |
| Value |
typography controls. |
See linked controls |
Design > Rating Filter
| Setting |
Purpose and options |
Behavior |
| Star Color |
Color or supported fill. |
Shared |
| Star Size |
Star size and unit. |
Responsive |
| Between Stars |
Between stars and unit. |
Responsive |
Design > Attribute Filter
| Setting |
Purpose and options |
Behavior |
| Button > Size > Size |
Custom, Small, Default, Large. |
Responsive |
| Button > Size > Padding |
Padding. When: Size = Custom. |
Responsive |
| Button > Size > Override Width |
Override width and unit. |
Shared |
| Button > Size > Full Width At |
Breakpoint. |
Shared |
| Button > Background |
Color or supported fill. |
Hover |
| Button > Outline |
On/off. |
Shared |
Shown when Outline is set.
| Setting |
Purpose and options |
Behavior |
| Button > Color |
Color or supported fill. |
Hover |
| Button > Width |
Width. |
Shared |
| Button > No Fill On Hover |
On/off. |
Shared |
| Setting |
Purpose and options |
Behavior |
| Button > Typography |
typography controls. |
See linked controls |
| Button > Corners |
Square, Round, Custom. |
Shared |
| Button > Corner Radius |
Corner radius and unit. When: Corners = Custom. |
Responsive |
| Button > Effects > Transition Duration |
Transition duration. |
Responsive |
| Button > Effects > Scale On Hover |
Set scale on hover. Range: 0–3. |
Responsive |
| Button > Effects > Shadow |
Shadow offset, blur, spread, color. |
Responsive, Hover |
| Button > Icon > Icon |
Icon. |
Shared |
| Button > Icon > Position |
Before, After. |
Shared |
| Button > Icon > Size |
Size and unit. |
Responsive |
| Button > Icon > Color |
Color or supported fill. |
Hover |
| Button > Icon > Space Before |
Space before and unit. |
Responsive |
| Button > Icon > Space After |
Space after and unit. |
Responsive |
| Button > Icon > Hover Transform |
Hover transform and unit. |
Shared |
Design > Spacing
| Setting |
Purpose and options |
Behavior |
| After Titles |
After titles and unit. |
Responsive |
| Between Filters |
Between filters and unit. |
Responsive |
| Container |
spacing controls. |
See linked controls |
Design > Advanced
Troubleshooting
The attribute chooser is empty
Create and assign the relevant global product attributes in WooCommerce.
Filtering does not affect the expected products
Use the filters with the product archive's main query and check the listing's query configuration.