Table of Contents

Advanced Custom Fields Repeater Addon

Description

The Repeater field provides a neat solution for repeating content – think slides, team members, CTA tiles and alike.

This field type acts as a parent to a set of sub fields which can be repeated again and again. What makes this field type so special is its versatility. Any kind of field can be used within a Repeater, and there are no limits to the number of repeats either (?‍? unless defined in the field settings).

The Repeater field settings

Advanced Custom Fields Repeater Addon

Settings

  • Sub Fields
    Defines the set of repeatable sub fields.
  • Collapsed
    Enables each row to be collapsed by specifying a single sub field to display.
  • Minimum Rows
    Sets a limit on how many rows of data are required.
  • Maximum Rows
    Sets a limit on how many rows of data are allowed.
  • Layout
    Defines the layout style of the appearance of the sub fields.
    Table: Sub fields are displayed in a table. Labels will appear in the table header.
    Block: Sub fields are displayed in blocks, one after the other.
    Row: Sub fields are displayed in a two column table. Labels will appear in the first column.
  • Button Label
    The text shown in the ‘Add Row’ button.

Advanced Custom Fields Repeater Addon

Template usage

The Repeater field will return an array of rows, where each row is an array containing sub field values.

For the best developer experience, we created some extra functions specifically for looping over rows and accessing sub field values. These are the have_rows, the_row, get_sub_field, and the_sub_field functions.