Products List

Products List displays a WooCommerce product listing with configurable product selection and presentation. Use it for a native store listing or a selected product group. WooCommerce must be installed and active.

Add and configure Products List

1. Click Add, choose Products List, and place it in the container.
2. Configure Content > Content > Show Products and the corresponding Products, Query, count, and ordering controls.
3. Configure Filter Bar if needed.
4. Style Design > Elements, Layout, Product Wrapper, Filter Bar, and Spacing.
5. Save your changes.

This element has no children; use its own controls.

Sliders and Quantity Inputs

To display products as slides, open the Design tab and set Layout > Layout > Slider. Open Slider to configure navigation, pagination, speed, and autoplay. Slider > Settings > Infinite cycles through the selected products; it does not fetch additional products. See shared slider controls.

Under Elements > Quantity Input, set Include > Enable to display quantity fields on product cards where supported by the product's purchase behavior. Style the fields and plus/minus buttons through WooCommerce Global Settings. Variable products may require shoppers to choose options before adding them to the cart.

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 > Content

Setting	Purpose and options	Behavior
Show Products	All, Featured, On sale, Manually, Query.	Shared
Products	Set products. When: Show Products = Manually.	Shared
Query	Set query. When: Show Products = Query.	Shared
Product Count	Set the numeric product count value.	Shared
Order By	Date, Price, Random.	Shared
Order	Descending, Ascending.	Shared
Advanced > When Empty	Existing Global Block.	Shared

Content > Filter Bar

Setting	Purpose and options	Behavior
Enable	On/off.	Shared
Type	Choose an available type from the list. When: Enable is set.	Shared
All Filter	On/off. When: Enable is set.	Shared
All Label	Enter the all label. When: All Filter is set and Enable is set.	Shared
Sort By	Name (A-Z), Name (Z-A), Term Order, Count.	Shared
Hide Uncategorized	On/off.	Shared

Design > Elements

Setting	Purpose and options	Behavior
Image > Include	Enable, Disable.	Shared
Image > Space Before	Space before and unit.	Responsive
Image > Space After	Space after and unit.	Responsive
Image > Order	Numeric order.	Responsive
Image > Borders	borders controls.	See linked controls
Image > Show Second Image On Hover	On/off.	Shared
Image > Transition Duration	Transition duration. When: Show Second Image On Hover is set.	Shared
Title > Include	Enable, Disable.	Shared
Title > Space After	Space after and unit.	Responsive
Title > Order	Numeric order.	Responsive
Title > Typography	typography controls.	See linked controls
Price > Include	Enable, Disable.	Shared
Price > Space After	Space after and unit.	Responsive
Price > Order	Numeric order.	Responsive
Price > Old Price Typography	typography controls.	See linked controls
Price > Current Price Typography	typography controls.	See linked controls
Rating > Include	Enable, Disable.	Shared
Rating > Space After	Space after and unit.	Responsive
Rating > Order	Numeric order.	Responsive
Rating > Review Count	On/off.	Shared
Rating > Count Typography	typography controls.	See linked controls
Sale Badge > Include	Enable, Disable.	Shared
Sale Badge > Position	Top Left, Top Right.	Responsive
Sale Badge > Background	Color or supported fill.	Shared
Sale Badge > Typography	typography controls.	See linked controls
Sale Badge > Borders	borders controls.	See linked controls
Sale Badge > Padding	spacing controls.	See linked controls
Sale Badge > Nudge > X	X and unit.	Responsive
Sale Badge > Nudge > Y	Y and unit.	Responsive
Excerpt > Include	Enable, Disable.	Shared
Excerpt > Space After	Space after and unit.	Responsive
Excerpt > Order	Numeric order.	Responsive
Excerpt > Typography	typography controls.	See linked controls
Categories > Include	Enable, Disable.	Shared
Categories > Space After	Space after and unit.	Responsive
Categories > Order	Numeric order.	Responsive
Categories > Typography	typography controls.	See linked controls
Quantity Input > Include	Enable, Disable.	Shared
Quantity Input > Space After	Space after and unit.	Responsive
Button > Include	Enable, Disable.	Shared
Button > Space After	Space after and unit. When: Include = Enable.	Responsive
Button > Styles > Size > Size	Custom, Small, Default, Large.	Responsive
Button > Styles > Size > Padding	Padding. When: Size = Custom.	Responsive
Button > Styles > Size > Override Width	Override width and unit.	Shared
Button > Styles > Size > Full Width At	Breakpoint.	Shared
Button > Styles > Background	Color or supported fill.	Hover
Button > Styles > Outline	On/off.	Shared

Shown when Outline is set.

Setting	Purpose and options	Behavior
Button > Styles > Color	Color or supported fill.	Hover
Button > Styles > Width	Width.	Shared
Button > Styles > No Fill On Hover	On/off.	Shared

Setting	Purpose and options	Behavior
Button > Styles > Typography	typography controls.	See linked controls
Button > Styles > Corners	Square, Round, Custom.	Shared
Button > Styles > Corner Radius	Corner radius and unit. When: Corners = Custom.	Responsive
Button > Styles > Effects > Transition Duration	Transition duration.	Responsive
Button > Styles > Effects > Scale On Hover	Set scale on hover. Range: 0–3.	Responsive
Button > Styles > Effects > Shadow	Shadow offset, blur, spread, color.	Responsive, Hover
Button > Styles > Icon > Icon	Icon.	Shared
Button > Styles > Icon > Position	Before, After.	Shared
Button > Styles > Icon > Size	Size and unit.	Responsive
Button > Styles > Icon > Color	Color or supported fill.	Hover
Button > Styles > Icon > Space Before	Space before and unit.	Responsive
Button > Styles > Icon > Space After	Space after and unit.	Responsive
Button > Styles > Icon > Hover Transform	Hover transform and unit.	Shared
Custom Areas > Areas	Add, edit, remove, and reorder areas.	Shared
Custom Areas > Areas > Global Block	Existing Global Block.	Shared
Custom Areas > Areas > Position	Inside Link, Outside Link.	Shared
Custom Areas > Areas > Space Before	Space before and unit.	Responsive
Custom Areas > Areas > Space After	Space after and unit.	Responsive
Custom Areas > Areas > Order	Numeric order.	Shared

Design > Layout

Setting	Purpose and options	Behavior
Layout	Grid, Slider, Masonry.	Shared
Slider	slider controls. When: Layout = Slider.	See linked controls
Products Per Row	Set the numeric products per row value. When: Layout ≠ Slider.	Responsive
Between Products	Between products and unit. When: Layout ≠ Slider.	Responsive

Design > Product Wrapper

Setting	Purpose and options	Behavior
Align Content	Left, Center, Right.	Shared
Background	Color or supported fill.	Shared
Borders	borders controls.	See linked controls
Padding	spacing controls.	See linked controls

Design > Filter Bar

Setting	Purpose and options	Behavior
Vertical	On/off. When: Enable is set.	Shared
Tabs Width	Tabs width and unit. When: Enable is set and Vertical is set.	Responsive
Horizontal At	Breakpoint. When: Enable is set and Vertical is set.	Shared
Style	Tabs, Pills, Bar. When: Enable is set.	Shared
Position	Left, Right. When: Enable is set and Vertical is set.	Shared
Position	Left, Center, Right, Full Width. When: Enable is set and Vertical is unset.	Shared
Space Between	Space between and unit. When: Enable is set and Position ≠ Full Width or Style ≠ Bar.	Shared
Space After	Space after and unit. When: Enable is set and Position ≠ Full Width.	Responsive

Shown when Enable is set and Style = Bar.

Setting	Purpose and options	Behavior
Bar > Separator	Color or supported fill.	Shared
Bar > Radius	Radius and unit.	Shared
Bar > Shadow	Shadow offset, blur, spread, color.	Shared

Setting	Purpose and options	Behavior
Pill Radius	Pill radius and unit. When: Enable is set and Style = Pills.	Shared
Separator > Color	Color or supported fill. When: Enable is set and Style = Tabs.	Shared
Separator > Width	Width. When: Enable is set and Style = Tabs.	Shared

Shown when Enable is set.

Setting	Purpose and options	Behavior
Text > Typography	typography controls.	See linked controls
Text > Hover	Color or supported fill.	Shared
Text > Active	Color or supported fill.	Shared
Background > Inactive	Color or supported fill.	Shared
Background > Hover	Color or supported fill.	Shared
Background > Active	Color or supported fill.	Shared

Shown when Enable is set and Style ≠ Pills.

Setting	Purpose and options	Behavior
Underline > Hover	Color or supported fill.	Shared
Underline > Active	Color or supported fill.	Shared
Underline > Width	Width.	Shared
Underline > Radius	Radius and unit.	Shared

Setting	Purpose and options	Behavior
Padding > Vertical	Vertical and unit. When: Enable is set.	Shared
Padding > Horizontal	Horizontal and unit. When: Enable is set.	Shared
Icon > Size	Size and unit. When: Enable is set and Align ≠ none.	Shared

Shown when Enable is set.

Setting	Purpose and options	Behavior
Icon > Nudge > Nudge X	Nudge x and unit.	Shared
Icon > Nudge > Nudge Y	Nudge y and unit.	Shared
Icon > After Icon	After icon and unit.	Shared
Responsive > Show as Dropdown	On/off.	Shared

Shown when Enable is set and Show as Dropdown is set.

Setting	Purpose and options	Behavior
Responsive > Visible At	Breakpoint.	Shared
Responsive > Dropdown Styles > Background	Color or supported fill.	Shared
Responsive > Dropdown Styles > Borders	borders controls.	See linked controls
Responsive > Dropdown Styles > Padding	spacing controls.	See linked controls
Responsive > Dropdown Styles > Typography	typography controls.	See linked controls

Setting	Purpose and options	Behavior
Responsive > Show Affordance	On/off. When: Enable is set and Show as Dropdown is unset.	Shared
Responsive > Color	Color or supported fill. When: Enable is set and Show Affordance is set.	Shared
Transition Effect	Transition effect and unit. When: Enable is set.	Shared

Design > Spacing

Setting	Purpose and options	Behavior
Spacing	spacing controls.	See linked controls

Design > Advanced

Setting	Purpose and options	Behavior
Override Global Styles	woocommerce global styles.	See linked controls

Troubleshooting