DynamicPress extends Bricks Builder’s Query Loop to support custom field repeater data as a native query type. This lets you loop through repeater field items – just like looping through posts or terms – directly in Bricks without writing PHP.
How It Works #
When you register a custom field as a repeater in your site configuration, DynamicPress hooks into Bricks’ query type system and registers a new entry called DP Repeater [Field Label]. This appears in the Query Loop type dropdown inside Bricks Builder.
At runtime, the extension fetches the repeater array from post meta for the current post and feeds each item as the loop object, exactly like a post loop feeds post objects.
Dynamic Tags Inside the Loop #
Tag format inside a repeater loop: {dp_cf_fieldname}
For each registered repeater field, DynamicPress automatically registers a matching tag. Inside the loop, the tag outputs the current item’s value. Outside the loop, it falls back to the first item.
| Field name: team_member → Tag: {dp_cf_team_member} Field name: gallery_item → Tag: {dp_cf_gallery_item} Field name: price_tier → Tag: {dp_cf_price_tier} |
For grouped repeaters (where each row is an array with sub-keys), access sub-fields with:
| Field: ‘features’, subfield: ‘title’ → Tag: {dp_cf_features_title} Field: ‘features’, subfield: ‘price’ → Tag: {dp_cf_features_price} |
Compatibility #
| Plugin / Source | Support Level |
| ACF Repeater | Fully supported – field name is the ACF field key |
| Meta Box Group | Fully supported – field name is the group ID |
| JetEngine Repeater | Supported if stored as serialised array in post meta |
| Native WP Custom Fields | Supported for any field storing an array via update_post_meta |
