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. - Pagination
Added in ACF 6.0. Defines if the repeater should only load a set number of rows per page when editing the repeater in the admin. If disabled (which it is by default), all rows will be loaded at once. This setting does not affect template usage or results returned via the REST API. Note: This setting is not currently supported inside flexible content and other repeater fields. In these cases, this setting will not be shown. - Rows per page
Added in ACF 6.0. Sets the number of rows that are displayed on a page if the “Pagination” setting is enabled.
Link to heading#
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.
Link to heading#
