Skip to main content
Documentation/Elements & Controls Reference/Elements/Dynamic/Post Loop Builder

Post Loop Builder

Post Loop Builder queries posts and renders a selected Global Block once for each result. Use it when the post card needs a custom layout.

Add and configure Post Loop Builder

  1. Click Add, choose Post Loop Builder, and place it in the container.
  2. Create the repeated card as a Global Block, using post-context elements or dynamic data.
  3. Choose Content > Repeated Block > Global Block and set its Tag and Advanced options.
  4. Configure Query, Pagination, and Filter Bar.
  5. Style Design > List, Post, Container, Pagination, and Filter Bar.
  6. Save your changes.
Post Loop Builder controls in the Breakdance editor
Post Loop Builder controls in the Breakdance editor

This element has no children; use its own controls.

Content and front-end behavior

The repeated design is stored in the selected Global Block. Changing that block changes the repeated layout wherever it is reused. Query and field concepts belong in Dynamic Data; this reference covers the loop element's own controls. Raw Mode is an advanced output option: inspect the resulting markup before relying on the ordinary list styling.

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 > Repeated Block

Setting Purpose and options Behavior
Global Block Existing Global Block. Shared
Tag article, section, div. Shared
Advanced > Alternates Add, edit, remove, and reorder alternates. Shared
Advanced > Alternates > Global Block Existing Global Block. Shared
Advanced > Alternates > Position Set the numeric position value. Shared
Advanced > Alternates > Repeat On/off. Shared
Advanced > Alternates > Frequency Set the numeric frequency value. When: Repeat is set. Shared
Advanced > Static Items Add, edit, remove, and reorder static items. Shared
Advanced > Static Items > Global Block Existing Global Block. Shared
Advanced > Static Items > Position Set the numeric position value. Shared
Advanced > Static Items > Repeat On/off. Shared
Advanced > Static Items > Frequency Set the numeric frequency value. When: Repeat is set. 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. When: Raw Mode is unset. Shared
Type Choose an available type from the list. When: Raw Mode is unset and Enable is set. Shared
All Filter On/off. When: Raw Mode is unset and Enable is set. Shared
All Label Enter the all label. When: Raw Mode is unset and All Filter is set and Enable is set. Shared
Sort By Name (A-Z), Name (Z-A), Term Order, Count. When: Raw Mode is unset. Shared
Hide Uncategorized On/off. When: Raw Mode is unset. Shared

Content > Advanced

Setting Purpose and options Behavior
Raw Mode On/off. Shared

Design > List

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

Shown when Raw Mode is unset and 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 Raw Mode is unset and 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: Raw Mode is unset and Layout = Accordion. Hover
Accordion > Item > Padding spacing controls. When: Raw Mode is unset and Layout = Accordion. See linked controls
Accordion > Item > Borders borders controls. When: Raw Mode is unset and Layout = Accordion and Style = Pills. See linked controls

Shown when Raw Mode is unset and 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 Raw Mode is unset and 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: Raw Mode is unset and Layout = Tabs and Vertical is set. Responsive
Tabs > Styles > Horizontal At Breakpoint. When: Raw Mode is unset and Layout = Tabs and Vertical is set. Shared
Tabs > Styles > Style Tabs, Pills, Bar. When: Raw Mode is unset and Layout = Tabs. Shared
Tabs > Styles > Position Left, Right. When: Raw Mode is unset and Layout = Tabs and Vertical is set. Shared
Tabs > Styles > Position Left, Center, Right, Full Width. When: Raw Mode is unset and Layout = Tabs and Vertical is unset. Shared
Tabs > Styles > Space Between Space between and unit. When: Raw Mode is unset and Layout = Tabs and Position ≠ Full Width or Style ≠ Bar. Shared
Tabs > Styles > Space After Space after and unit. When: Raw Mode is unset and Layout = Tabs and Position ≠ Full Width. Responsive

Shown when Raw Mode is unset and 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: Raw Mode is unset and Layout = Tabs and Style = Pills. Shared
Tabs > Styles > Separator > Color Color or supported fill. When: Raw Mode is unset and Layout = Tabs and Style = Tabs. Shared
Tabs > Styles > Separator > Width Width. When: Raw Mode is unset and Layout = Tabs and Style = Tabs. Shared

Shown when Raw Mode is unset and 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 Raw Mode is unset and 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: Raw Mode is unset and Layout = Tabs. Shared
Tabs > Styles > Padding > Horizontal Horizontal and unit. When: Raw Mode is unset and Layout = Tabs. Shared
Tabs > Styles > Icon > Size Size and unit. When: Raw Mode is unset and Layout = Tabs and Align ≠ none. Shared

Shown when Raw Mode is unset and 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 Raw Mode is unset and 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: Raw Mode is unset and Layout = Tabs and Show as Dropdown is unset. Shared
Tabs > Styles > Responsive > Color Color or supported fill. When: Raw Mode is unset and Layout = Tabs and Show Affordance is set. Shared
Tabs > Styles > Transition Effect Transition effect and unit. When: Raw Mode is unset and Layout = Tabs. Shared
Items Per Row Set the numeric items per row value. When: Raw Mode is unset and Layout = Grid, Masonry. Responsive
One Item At Breakpoint. When: Raw Mode is unset and Layout = Grid, Masonry. Shared
Space Between Items Space between items and unit. When: Raw Mode is unset and Layout ≠ Slider, Accordion, Tabs. Responsive

Design > Post

Shown when Raw Mode is unset.

Setting Purpose and options Behavior
Background Color or supported fill. Shared
Borders borders controls. See linked controls
Padding spacing controls. See linked controls

Design > Container

Shown when Raw Mode is unset.

Setting Purpose and options Behavior
Background Color or supported fill. Shared
Borders borders controls. See linked controls
Padding spacing controls. See linked controls

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 and Raw Mode is unset. Shared
Tabs Width Tabs width and unit. When: Enable is set and Raw Mode is unset and Vertical is set. Responsive
Horizontal At Breakpoint. When: Enable is set and Raw Mode is unset and Vertical is set. Shared
Style Tabs, Pills, Bar. When: Enable is set and Raw Mode is unset. Shared
Position Left, Right. When: Enable is set and Raw Mode is unset and Vertical is set. Shared
Position Left, Center, Right, Full Width. When: Enable is set and Raw Mode is unset and Vertical is unset. Shared
Space Between Space between and unit. When: Enable is set and Raw Mode is unset and Position ≠ Full Width or Style ≠ Bar. Shared
Space After Space after and unit. When: Enable is set and Raw Mode is unset and Position ≠ Full Width. Responsive

Shown when Enable is set and Raw Mode is unset 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 Raw Mode is unset and Style = Pills. Shared
Separator > Color Color or supported fill. When: Enable is set and Raw Mode is unset and Style = Tabs. Shared
Separator > Width Width. When: Enable is set and Raw Mode is unset and Style = Tabs. Shared

Shown when Enable is set and Raw Mode is unset.

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 Raw Mode is unset 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 and Raw Mode is unset. Shared
Padding > Horizontal Horizontal and unit. When: Enable is set and Raw Mode is unset. Shared
Icon > Size Size and unit. When: Enable is set and Raw Mode is unset and Align ≠ none. Shared

Shown when Enable is set and Raw Mode is unset.

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 Raw Mode is unset 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 Raw Mode is unset and Show as Dropdown is unset. Shared
Responsive > Color Color or supported fill. When: Enable is set and Raw Mode is unset and Show Affordance is set. Shared
Transition Effect Transition effect and unit. When: Enable is set and Raw Mode is unset. Shared

Design > Spacing

Setting Purpose and options Behavior
Spacing spacing controls. When: Raw Mode is unset. See linked controls

Troubleshooting

Every result displays the same content

Check that the Global Block uses current-post fields instead of fixed text or a fixed post binding.

No results appear

Verify the selected Global Block and Query separately. Check that matching published posts exist.