Skip to main content
Get Oxygen
Documentation/Elements Reference/Dynamic/Repeater Field
Elements Reference

Repeater Field

The Repeater Field element repeats one component once per row of a repeater custom field —
an ACF Repeater, a Meta Box cloneable group. Each rendered item resolves dynamic data
against its own row, so a component built from subfields fills itself in.
Repeater Fields is the guide to building with it; this page
is the element's controls.

Repeated Block

  • Component — the component rendered once per row. Until you pick one, each item renders
    "Choose a Component from the dropdown." Edit Component opens it in the builder.
  • Tag — the HTML tag each item is wrapped in: article (the default), section, or
    div.
  • Advanced opens a popout with three things, each covered in the Loops section:
    • Alternates — a different component at a given position, optionally repeating on a
      frequency. See Alternate & Static Items.
    • Static Items — a component inserted at a position without consuming a row, again
      with an optional repeat frequency. Same article.
    • When Empty — the component rendered instead of the loop when the field has no rows.
      See Empty State.

Field

  • Repeater Field — the field to loop over. The dropdown lists the repeater fields your
    site's custom-field plugins register; it reads "No field selected" until you choose one.
    Which plugins are supported is covered in
    Dynamic Data Integrations.
  • Item Title — the heading text for each item, used only when the list is laid out as an
    accordion or tabs. It accepts dynamic data, so each row can title itself from one of its
    subfields.

On the front end

The element renders a div.bde-repeater-element containing a div.bde-loop wrapper, and
inside it one element per row using the Tag you chose, each carrying bde-loop-item bde-dynamic-repeater-item. The component's markup is rendered inside each item.