PUBLIC DOCUMENTATION

Fields, content types and visual FSE editing with DMBB.

← All Help Topics
HOW TO USE · VERSION 9.5.0

Repeater (Pro)

Create repeatable rows using simple subfields.

Screenshots and walkthrough — expand to view

Screenshots use sample data and English labels. Follow the translated instructions on this page; your theme, language, permissions and license can change the available controls. Select an image to view it at full size.

Repeater field: builder settings, storage key and validation options.
Repeater field: builder settings, storage key and validation options.
Repeater field: sample controls in the content editor.
Repeater field: sample controls in the content editor.
What it does Stores a list of rows where every row has the same subfields.
Use it when FAQs, team members, features, specifications or simple item lists.
How to configure Select Repeater, then add subfields. Keep the structure one level deep.
Saved as An array of row arrays in post meta.
EXAMPLE

Team Member

name + role + email
Read a Repeater Field in PHP

Use the field Key from the builder as the second argument of get_post_meta(). Escape or sanitize the value for its final output context.

$rows = get_post_meta( get_the_ID(), 'your_meta_key', true );
$rows = is_array( $rows ) ? $rows : array();

foreach ( $rows as $row ) {
    $name = isset( $row['name'] ) ? $row['name'] : '';
    $role = isset( $row['role'] ) ? $row['role'] : '';

    echo '<h3>' . esc_html( $name ) . '</h3>';
    echo '<p>' . esc_html( $role ) . '</p>';
}
A Repeater stores an array of row arrays. Each row uses the subfield Key you configured. If a subfield is an Image, Gallery or Multi Select, that subfield keeps its own special array/attachment-ID structure. Security: Escape the value for its output context; do not print unescaped post meta directly into HTML.
Design choice: nested repeaters are intentionally excluded. Use separate boxes or grouped fields for more complex structures.

Documentation for Dynamic Meta Box Builder 9.5.0.