Nested Repeater

A nested repeater is a repeater that adds additional data that you want to repeat separately from the parent repeater - inserted into another repeater.

As an example, in the case of a team, the nested repeater could be a "skills" list. Another advantage is that the nested repeater can be styled separately to further personalise your design.

triangle-exclamation

Parent Repeater

Without nested repeater

Nested Repeater inside Parent

Set up Nested ACF Repeater inside your Parent Repeater

In order to set up a nested repeater in the editor, we need to edit the parent ACF repeater from the dashboard.

  • Navigate to Custom Fields

  • Find the repeater group to which you wish to add a nested repeater.

  • Click to open.

  • Click the repeater to open it up.

  • Find Sub Fields and click "+ Add Field".

  • Find Field Type.

  • Choose repeater in the dropdown.

  • Input nested repeater name.

  • Click "+ Add Field".

  • Open the Field Type dropdown and choose the required field type, depending on what type of additional data you want to add.

  • Find Field Label and add the name of the data you are adding.

  • Click "+ Add New Field" if you want to add additional Field Types.

  • Click the "Save Changes" button to save your new nested repeater.

Set up Nested Repeater Fields in the Editor

  • Find the Nested Repeater Field(s) in the repeater window at the bottom of the editor.

  • Click "Add Row".

  • Input the required fields of the Nested Repeater.

  • Add as many rows as desired and input your data.

circle-exclamation
  • When you have completed the data fields, you need to add the nested repeater inside the parent repeater.

  • To do this, select the parent repeateror the block inside the parent repeater where you want your nested repeater to appear.

  • Add a new repeater block (for your nested repeater).

  • Navigate to the Primary tab of the Block Inspector.

  • Select Repeater in the Source dropdown.

triangle-exclamation

  • Find Field.

  • In the dropdown, select the Nested Repeater you want to add ( already created in the Dashboard).

  • Now, in the Placeholder, click "+ Add Block".

  • Choose the type of block you require for the data of your nested repeater.

  • With the block selected, click the dynamic data icon.

  • Select Repeater in the Source dropdown.

triangle-exclamation
  • Choose required field in dropdown (the nested repeater field you created before in the dashboard).

  • You can customise your nested repeater in the usual way.

Last updated

Was this helpful?