Post List

Post List queries posts and displays them using a built-in card structure. Use it when its image, title, metadata, content, and button controls suit the listing you need.

Add and configure Post List

1. Click Add, choose Post List, and place it in the container.
2. Configure Content > Post to choose the card content and its options.
3. Set Content > Query > Query for the posts to display; see Dynamic Data for query concepts.
4. Configure Pagination and Filter Bar if needed.
5. Style Design > Post, List, Pagination, and Filter Bar.
6. 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 > Post

Setting	Purpose and options	Behavior
Image > Disable	On/off. When: Use Global Block is unset.	Shared
Image > Fallback Image	WordPress media. When: Use Global Block is unset.	Shared
Image > Size	Registered WordPress or custom image size. When: Use Global Block is unset and Fallback Image is set.	Shared

Shown when Use Global Block is unset.

Setting	Purpose and options	Behavior
Image > Disable Post Title As Alt Tag	On/off.	Shared
Title > Disable	On/off.	Shared
Title > Tag	H1, H2, H3, H4, H5, H6, span, div.	Shared
Meta > Disable	On/off.	Shared
Meta > Meta	Set meta.	Shared
Meta > Separator	Enter the separator.	Shared
Meta > Link	Destination and link options.	Shared
Taxonomy > Disable	On/off.	Shared
Taxonomy > Type	Categories, Tags.	Shared
Taxonomy > Count	Set the numeric count value.	Shared
Taxonomy > Separator	Enter the separator.	Shared
Taxonomy > Link	Destination and link options.	Shared
Content > Disable	On/off.	Shared
Content > Type	Excerpt, Content.	Shared

Setting	Purpose and options	Behavior
Content > Excerpt Length	Set the numeric excerpt length value. When: Use Global Block is unset and Type = Excerpt.	Shared

Shown when Use Global Block is unset.

Setting	Purpose and options	Behavior
Button > Disable	On/off.	Shared
Button > Button Text	Enter the button text.	Shared
Button > Aria Label	Enter the aria label.	Shared
Open In New Tab	On/off.	Shared
Tag	article, section, div.	Shared
Advanced > When Empty	Existing Global Block.	Shared

Content > Query

Setting	Purpose and options	Behavior
Query	Set query.	Shared

Content > Pagination

Setting	Purpose and options	Behavior
Pagination	None, Numbers, Previous / Next, Numbers + Previous / Next, Load More Button, Infinite Scroll. When: Enable is unset.	Shared
Previous Text	Enter the previous text. When: Enable is unset and Pagination = Previous / Next, Numbers + Previous / Next.	Shared
Next Text	Enter the next text. When: Enable is unset and Pagination = Previous / Next, Numbers + Previous / Next.	Shared
Show All Page Numbers	On/off. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next.	Shared
Load More Text	Enter the load more text. When: Enable is unset and Pagination = Load More Button.	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 > Post

Setting	Purpose and options	Behavior
Container > Background	Color or supported fill.	Shared
Container > Borders	borders controls.	See linked controls
Container > Padding	spacing controls.	See linked controls
Container > Alignment	Left, Center, Right, Justify.	Shared
Image > Position	Top, Left, Right, Bottom.	Shared
Image > Stack Vertically At	Breakpoint. When: Position = Left, Right.	Shared
Image > Space	Space and unit.	Responsive
Image > Borders	borders controls.	See linked controls
Image > Width	Width.	Responsive
Image > Aspect Ratio	Set aspect ratio. Range: 0–4.	Responsive
Title > Typography	typography controls.	See linked controls
Title > Space Below	Space below and unit.	Responsive
Title > Order	Numeric order.	Shared
Meta > Text	typography controls.	See linked controls
Meta > Separator	Color or supported fill.	Shared
Meta > Space Between	Space between and unit.	Responsive
Meta > Space Below	Space below and unit.	Responsive
Meta > Order	Numeric order.	Shared
Taxonomy > Text	typography controls.	See linked controls
Taxonomy > Separator	Color or supported fill.	Shared
Taxonomy > Space Between	Space between and unit.	Responsive
Taxonomy > Space Below	Space below and unit.	Responsive
Taxonomy > Order	Numeric order.	Shared
Content > Typography	typography controls.	See linked controls
Content > Space Below	Space below and unit.	Responsive
Content > Order	Numeric order.	Shared
Button > Style	Primary, Secondary, Custom, Text.	Shared

Shown when Style = Text.

Setting	Purpose and options	Behavior
Button > Text > Typography	typography controls.	See linked controls
Button > Text > Padding	spacing controls.	See linked controls
Button > Text > Fancy Underline	Style 1, Style 2, Style 3, Style 4, Style 5, Style 6, Style 7, Style 8.	Shared
Button > Text > Underline Color	Color or supported fill.	Hover
Button > Text > Arrow > Arrow	Arrow 1, Arrow 2, Arrow 3, Custom.	Shared

Setting	Purpose and options	Behavior
Button > Text > Arrow > Custom Arrow	Icon. When: Style = Text and Arrow = Custom.	Shared
Button > Text > Arrow > Space Before	Space before and unit. When: Style = Text.	Shared
Button > Text > Arrow > Hover Transform	Hover transform and unit. When: Style = Text and Arrow ≠ Arrow 3.	Shared
Button > Text > Arrow > Arrow Size	Arrow size and unit. When: Style = Text.	Shared
Button > Custom Type	Custom, Preset. When: Style = Custom.	Shared
Button > Custom > Size > Size	Custom, Small, Default, Large. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	Responsive
Button > Custom > Size > Padding	Padding. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Size = Custom.	Responsive

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting	Purpose and options	Behavior
Button > Custom > Size > Override Width	Override width and unit.	Shared
Button > Custom > Size > Full Width At	Breakpoint.	Shared
Button > Custom > Background	Color or supported fill.	Hover
Button > Custom > Outline	On/off.	Shared

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Outline is set.

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

Setting	Purpose and options	Behavior
Button > Custom > Typography	typography controls. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	See linked controls
Button > Custom > Corners	Square, Round, Custom. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	Shared
Button > Custom > Corner Radius	Corner radius and unit. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Corners = Custom.	Responsive

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting	Purpose and options	Behavior
Button > Custom > Icon > Icon	Icon.	Shared
Button > Custom > Icon > Position	Before, After.	Shared
Button > Custom > Icon > Size	Size and unit.	Responsive
Button > Custom > Icon > Color	Color or supported fill.	Hover
Button > Custom > Icon > Space Before	Space before and unit.	Responsive
Button > Custom > Icon > Space After	Space after and unit.	Responsive
Button > Custom > Icon > Hover Transform	Hover transform and unit.	Shared
Button > Custom > Effects > Transition Duration	Transition duration.	Responsive
Button > Custom > Effects > Scale On Hover	Set scale on hover. Range: 0–3.	Responsive
Button > Custom > Effects > Shadow	Shadow offset, blur, spread, color.	Responsive, Hover

Setting	Purpose and options	Behavior
Button > Preset	Set preset. When: Style = Custom and Custom Type = Preset.	Shared

Design > List

Setting	Purpose and options	Behavior
Width	Width.	Responsive
Layout	List, Grid, Slider, Accordion, Tabs, Masonry.	Shared
Slider	slider controls. When: Layout = Slider.	See linked controls

Shown when Layout = Accordion.

Setting	Purpose and options	Behavior
Accordion > Accordion	On/off.	Shared
Accordion > First Item Opened	On/off.	Shared
Accordion > Item > Style	Bordered, Pills.	Shared
Accordion > Item > Icon > Position	Left, Right.	Shared
Accordion > Item > Icon > Icon	Icon.	Shared
Accordion > Item > Icon > Active Icon	Icon.	Shared
Accordion > Item > Icon > Size	Size and unit.	Responsive
Accordion > Item > Icon > Color	Color or supported fill.	Shared
Accordion > Item > Icon > Active Color	Color or supported fill.	Shared

Shown when Layout = Accordion and Style = Bordered.

Setting	Purpose and options	Behavior
Accordion > Item > Bordered > Border Color	Color or supported fill.	Shared
Accordion > Item > Bordered > Border Width	Border width and unit.	Shared
Accordion > Item > Bordered > Border Radius	Border radius and unit.	Shared
Accordion > Item > Bordered > Bottom Only	On/off.	Shared

Setting	Purpose and options	Behavior
Accordion > Item > Background	Color or supported fill. When: Layout = Accordion.	Hover
Accordion > Item > Padding	spacing controls. When: Layout = Accordion.	See linked controls
Accordion > Item > Borders	borders controls. When: Layout = Accordion and Style = Pills.	See linked controls

Shown when Layout = Accordion.

Setting	Purpose and options	Behavior
Accordion > Item > Typography	typography controls.	See linked controls
Accordion > Item > Active > Text Color	Color or supported fill.	Shared
Accordion > Item > Active > Background	Color or supported fill.	Shared
Accordion > Item > Transition Duration	Transition duration.	Shared

Shown when Layout = Tabs.

Setting	Purpose and options	Behavior
Tabs > Active Tab	Set the numeric active tab value.	Shared
Tabs > Open On Hover	On/off.	Shared
Tabs > Styles > Vertical	On/off.	Shared

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

Shown when Layout = Tabs and Style = Bar.

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

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

Shown when Layout = Tabs.

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

Shown when Layout = Tabs and Style ≠ Pills.

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

Setting	Purpose and options	Behavior
Tabs > Styles > Padding > Vertical	Vertical and unit. When: Layout = Tabs.	Shared
Tabs > Styles > Padding > Horizontal	Horizontal and unit. When: Layout = Tabs.	Shared
Tabs > Styles > Icon > Size	Size and unit. When: Layout = Tabs and Align ≠ none.	Shared

Shown when Layout = Tabs.

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

Shown when Layout = Tabs and Show as Dropdown is set.

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

Setting	Purpose and options	Behavior
Tabs > Styles > Responsive > Show Affordance	On/off. When: Layout = Tabs and Show as Dropdown is unset.	Shared
Tabs > Styles > Responsive > Color	Color or supported fill. When: Layout = Tabs and Show Affordance is set.	Shared
Tabs > Styles > Transition Effect	Transition effect and unit. When: Layout = Tabs.	Shared
Items Per Row	Set the numeric items per row value. When: Layout = Grid, Masonry.	Responsive
One Item At	Breakpoint. When: Layout = Grid, Masonry.	Shared
Space Between Items	Space between items and unit. When: Layout ≠ Slider, Accordion, Tabs.	Responsive

Design > Pagination

Setting	Purpose and options	Behavior
Alignment	Left, Center, Right. When: Enable is unset.	Responsive
Space Above	Space above and unit. When: Enable is unset.	Responsive
Space Between	Space between and unit. When: Enable is unset and Pagination = Numbers, Previous / Next, Numbers + Previous / Next.	Responsive
Typography	typography controls. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next, Previous / Next.	See linked controls
Active Color	Color or supported fill. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next.	Shared
Display As Buttons	On/off. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next.	Shared

Shown when Enable is unset and Display As Buttons is set.

Setting	Purpose and options	Behavior
Buttons > Size	Size and unit.	Responsive
Buttons > Border	Color or supported fill.	Hover
Buttons > Background	Color or supported fill.	Hover
Buttons > Radius	Radius and unit.	Responsive
Buttons > Active > Border	Color or supported fill.	Shared
Buttons > Active > Background	Color or supported fill.	Shared
Buttons > Active > Text	Visible text.	Shared

Setting	Purpose and options	Behavior
Load More Button > Style	Primary, Secondary, Custom, Text. When: Enable is unset and Pagination = Load More Button.	Shared

Shown when Enable is unset and Pagination = Load More Button and Style = Text.

Setting	Purpose and options	Behavior
Load More Button > Text > Typography	typography controls.	See linked controls
Load More Button > Text > Padding	spacing controls.	See linked controls
Load More Button > Text > Fancy Underline	Style 1, Style 2, Style 3, Style 4, Style 5, Style 6, Style 7, Style 8.	Shared
Load More Button > Text > Underline Color	Color or supported fill.	Hover
Load More Button > Text > Arrow > Arrow	Arrow 1, Arrow 2, Arrow 3, Custom.	Shared

Setting	Purpose and options	Behavior
Load More Button > Text > Arrow > Custom Arrow	Icon. When: Enable is unset and Pagination = Load More Button and Style = Text and Arrow = Custom.	Shared
Load More Button > Text > Arrow > Space Before	Space before and unit. When: Enable is unset and Pagination = Load More Button and Style = Text.	Shared
Load More Button > Text > Arrow > Hover Transform	Hover transform and unit. When: Enable is unset and Pagination = Load More Button and Style = Text and Arrow ≠ Arrow 3.	Shared
Load More Button > Text > Arrow > Arrow Size	Arrow size and unit. When: Enable is unset and Pagination = Load More Button and Style = Text.	Shared
Load More Button > Custom Type	Custom, Preset. When: Enable is unset and Pagination = Load More Button and Style = Custom.	Shared
Load More Button > Custom > Size > Size	Custom, Small, Default, Large. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	Responsive
Load More Button > Custom > Size > Padding	Padding. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Size = Custom.	Responsive

Shown when Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting	Purpose and options	Behavior
Load More Button > Custom > Size > Override Width	Override width and unit.	Shared
Load More Button > Custom > Size > Full Width At	Breakpoint.	Shared
Load More Button > Custom > Background	Color or supported fill.	Hover
Load More Button > Custom > Outline	On/off.	Shared

Shown when Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Outline is set.

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

Setting	Purpose and options	Behavior
Load More Button > Custom > Typography	typography controls. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	See linked controls
Load More Button > Custom > Corners	Square, Round, Custom. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.	Shared
Load More Button > Custom > Corner Radius	Corner radius and unit. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Corners = Custom.	Responsive

Shown when Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting	Purpose and options	Behavior
Load More Button > Custom > Icon > Icon	Icon.	Shared
Load More Button > Custom > Icon > Position	Before, After.	Shared
Load More Button > Custom > Icon > Size	Size and unit.	Responsive
Load More Button > Custom > Icon > Color	Color or supported fill.	Hover
Load More Button > Custom > Icon > Space Before	Space before and unit.	Responsive
Load More Button > Custom > Icon > Space After	Space after and unit.	Responsive
Load More Button > Custom > Icon > Hover Transform	Hover transform and unit.	Shared
Load More Button > Custom > Effects > Transition Duration	Transition duration.	Responsive
Load More Button > Custom > Effects > Scale On Hover	Set scale on hover. Range: 0–3.	Responsive
Load More Button > Custom > Effects > Shadow	Shadow offset, blur, spread, color.	Responsive, Hover

Setting	Purpose and options	Behavior
Load More Button > Preset	Set preset. When: Enable is unset and Pagination = Load More Button and Style = Custom and Custom Type = Preset.	Shared

Shown when Enable is unset and Pagination = Infinite Scroll.

Setting	Purpose and options	Behavior
Show Loading Icon In Builder	On/off.	Shared
Loading Icon > Size	Size and unit.	Responsive
Loading Icon > Color	Color or supported fill.	Shared

Setting	Purpose and options	Behavior
Dots > Color	Color or supported fill. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next.	Shared
Dots > Nudge Y	Nudge y and unit. When: Enable is unset and Pagination = Numbers, Numbers + Previous / Next and Display As Buttons is set.	Responsive
Stack Horizontally	On/off. When: Enable is unset.	Shared
Vertical At	Breakpoint. When: Enable is unset and Stack Horizontally is set.	Shared

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

Troubleshooting