ACF Repeater Field: Complete Guide (Setup, Display, Elementor)

An ACF Repeater field lets you create a set of subfields once and then add as many rows of that data as you need. It is the field behind team sections, testimonials, pricing tiers, FAQs and event schedules, where the same details repeat for every item.

Elementor cannot display a Repeater field on its own. In this guide you will set up the field, fill in its rows, and display them in Elementor without code using Dynific Addons for Elementor, on a single page or on every post of a custom post type. Nested repeaters are covered too.

If you want a wider look at displaying ACF fields in Elementor without Elementor Pro, including basic fields, Flexible Content and Gallery, start with that guide.

Key takeaways

  • The Repeater field comes with ACF PRO, not the free ACF plugin.
  • Create the field once, and editors add as many rows as they need from the post editor.
  • Dynific Addons for Elementor displays the rows without code, on a page or on every post of a custom post type.

Is the ACF Repeater Field Free or Pro?

The Repeater field is part of ACF PRO. The free Advanced Custom Fields plugin does not include it, so with ACF you need a PRO licence to create Repeater fields.

The free version of ACF still covers the everyday field types, such as Text, Textarea, Number, Image, File, Select, Link, Post Object, Relationship and User. What it lacks is a way to repeat a group of them, which is exactly what the Repeater adds.

What Is the ACF Repeater Field?

The ACF Repeater field is a container field that holds a group of subfields that can be repeated as many times as needed. Think of it as a table: you define the columns (subfields) once, and editors add as many rows as the content requires.

A testimonials section is the classic example. Instead of creating separate field groups for Testimonial 1, Testimonial 2, and Testimonial 3, you create one Repeater field with subfields for Client Name, Feedback, and Photo. Editors can then add as many testimonial rows as they want from the WordPress admin, with no developer involvement.

Any ACF field type can be used as a subfield inside a Repeater, including other Repeater fields. Common subfield combinations:

  • Text + Image: Team members, testimonials, partner logos
  • Text + URL + Icon: Feature lists, service cards
  • Title + Description + Price: Pricing tiers, packages
  • Date + Title + Description: Event schedules, timelines

How to Set Up an ACF Repeater Field

This walkthrough uses a testimonials section as the example, with three subfields: Client Name,
Testimonial Text, and Client Photo.

Create a field group

  1. In your WordPress dashboard, go to ACF > Field Groups
  2. Click Add New
  3. Give the field group a descriptive name, for example Testimonials
Creating a new field group in ACF Pro
Creating a new field group in ACF Pro

Add the Repeater Field

  1. Click Add Field
  2. Set the Field Type to Repeater
  3. Give it a Field Label, for example Testimonials
  4. Check the Field Name, which fills in automatically as testimonials
Setting the Field Type to Repeater in ACF Pro
Setting the Field Type to Repeater in ACF Pro

Configure the Repeater Field Settings

Below the field label and name, the Repeater field has a handful of settings worth knowing:

Min RowsMinimum number of rows that must be added before the field group can be saved. Leave blank for no minimum.
Max RowsMaximum number of rows an editor can add. Leave blank for unlimited.
LayoutControls how subfields appear in the admin. Table: subfields as columns, best for short text.
Block: rows stack vertically, better for textareas.
Row: compact inline display.
Button LabelThe text on the ‘add row’ button. Change from the default ‘Add Row’ to something descriptive like ‘Add Testimonial’ to make the admin clearer for editors.
ACF Repeater field settings: layout, row limits, and button label
ACF Repeater field settings: layout, row limits, and button label

Add Subfields to the Repeater

Inside the Repeater field, click Add Sub Field to add the fields that will repeat with each row. For the testimonials example, add three subfields:

  • Client Name, a Text field
  • Client Photo, an Image field with Return Format set to Image Array
  • Client Message, a Textarea field
Three subfields added inside the ACF Repeater field
Three subfields added inside the ACF Repeater field

Set the Location Rules

Scroll down to the Location Rules section to tell ACF where this field group should appear. To show it on all pages, set Post Type is equal to Page. To show it on one page only, set Page is equal to your page name.

Location rules controlling where the Repeater field group appears in WordPress
Location rules controlling where the Repeater field group appears in WordPress

Save the Field Group

Click Save Changes (or Publish if it is a new field group). The Repeater field is now active and will appear on the pages or post types matching your location rules.

Dynific Addons for Elementor

Created your Repeater field?

Dynific Addons for Elementor shows every row on your pages as a grid, carousel, accordion or tabs, designed visually without code.

How Do You Add Rows to an ACF Repeater Field?

You add rows from the normal WordPress edit screen of any post or page the field group is assigned to.

  1. Open the page or post where the field group appears
  2. Scroll down to find the Testimonials field group below the content editor
  3. Click Add Testimonial (or your custom button label)
  4. Fill in the subfields for the first row: Client Name, Client Message, and Client Photo
  5. Click Add Testimonial again to add a second row
  6. Repeat as needed, then save or update the post

Rows can be reordered by dragging the handle on the left side of each row. Individual rows can be deleted using the delete icon on the right.

Populating ACF Repeater field data in the WordPress admin with two testimonial rows
Populating ACF Repeater field data in the WordPress admin with two testimonial rows

How Do You Display ACF Repeater Fields in Elementor?

Elementor does not support ACF Repeater fields in its dynamic data, so you need an addon. With Dynific Addons for Elementor, you design one row once as a block layout, then the DA – ACF Repeater widget repeats that design for every row.

Two widgets do the work. The DA – ACF Repeater widget loops through the rows on your page, and inside the block layout the DA – ACF Fields V2 widget pulls in each subfield value.

Design the Repeater Block Layout

  1. Go to Dynific Templates > Add New
  2. In the template type grid, choose ACF Blocks
  3. Set Field Location to Post, or to Options Page if your repeater lives on an options page, and set Field Type to Repeater
  4. Choose a Preview Post that already has repeater rows and select your Repeater field, for example Testimonials
  5. Name the template and click Edit with Elementor
  6. Build the layout for one row with a DA – ACF Fields V2 widget for each subfield, then style and save it
Designing the repeater block layout template in Elementor using Dynific Addons
Designing the repeater block layout template in Elementor using Dynific Addons

Add the DA – ACF Repeater widget to your page

  1. Open the page in the Elementor editor
  2. Search for the DA – ACF Repeater widget and drag it onto the page
  3. Set Block Layout to the template you just designed
  4. Set the Repeater Field to your field, for example Testimonials
  5. Choose a Skin: Default, Accordion or Tabs
  6. Adjust the layout settings, such as columns and spacing, and save the page
Configuring the DA – ACF Repeater widget with block layout and skin selected
Configuring the DA – ACF Repeater widget with block layout and skin selected

Which skin should you use? The Default skin gives you four layout modes, Grid, Carousel, Smart Grid and Checker Board, while Accordion and Tabs suit content that readers open one item at a time.

Default with GridRows in responsive columns, with separate column counts for desktop, tablet and mobile. Good for team members, testimonials and service cards.
Default with CarouselRows in a sliding carousel. Good for testimonials and portfolio entries.
AccordionRows as collapsible items. Good for FAQs and step lists where space is limited.
TabsRows as tabbed sections. Good for pricing tiers and grouped content.

How Do You Show Repeater Data on a Single Post Template?

To show repeater rows on every post of a custom post type, add the DA – ACF Repeater widget to a single post template. For example, if every Services post has its own Testimonials repeater, one template shows the right client reviews on each service page.

Before you start, create a Services custom post type and change the Testimonials field group’s location rule to Post Type is equal to Services. Our ACF guide for beginners shows how to set up the post type. Then build the template:

  1. Go to Dynific Templates > Add New and choose Single Post Template
  2. Name the template, for example Service Template, choose Services as the post type and pick a Preview Post that has testimonial rows
  3. Turn on Global Template so the template is used for every service page
  4. Click Edit with Elementor
  5. Add widgets for the service title and content
  6. Add the DA – ACF Repeater widget, then select your testimonials block layout and the Testimonials field
Single Post Template settings for the Services post type
Single Post Template settings for the Services post type

Open any service page on the front end and its own testimonials appear automatically, all following the same block layout.

How Do Nested Repeaters Work in ACF?

A nested repeater is a Repeater field that exists as a subfield inside another Repeater field. This is useful when each row in the parent repeater needs its own repeating set of data.

A pricing table is a common example: the parent repeater holds hosting platforms (Digital Ocean, Vultr, Linode), and inside each platform is a child repeater for the monthly plans, each with a price and feature list.

Set up nested repeaters in ACF

  1. Create the parent Repeater field, for example Hosting Platforms
  2. Add the parent’s own subfields, such as Platform Name and Description
  3. Click Add Sub Field again and set its type to Repeater. This is the child Repeater, for example Plans
  4. Add subfields to the child Repeater, such as Plan Name, Monthly Price and Features
  5. Set the location rules and save
A nested ACF Repeater setup: parent Repeater containing a child Repeater as a subfield
A nested ACF Repeater setup: parent Repeater containing a child Repeater as a subfield

Display nested repeaters in Elementor

Create a separate block layout for each level of the repeater, starting from the inside.

  • Child layout (Plans): designs how each plan row looks
  • Parent layout (Platforms): designs how each platform section looks, with a DA – ACF Repeater widget inside it that points to the Plans child repeater

Then place a DA – ACF Repeater widget on the page that points to the Platforms parent repeater. Each level keeps its own design, and no PHP is involved.

What Can You Build With ACF Repeater Fields?

The Repeater field works for any content that repeats in sets. Some of the most common implementations:

Testimonials and reviewsClient name, photo, review text, star rating. Each row is one testimonial. Renders as a
grid or carousel.
Team member sectionsName, role, photo, bio, social links. Each row is one person. Common on About pages
and agency sites.
FAQ sectionsQuestion and Answer subfields. Each row is one FAQ pair. Combine with the Accordion
skin in Dynific Addons for a collapsible display.
Pricing tablesPlan name, price, billing period, feature list. Each row is one pricing tier. Often the child
of a parent repeater grouping plans by category.
Service or feature listsIcon, title, short description. Each row is one feature card. Renders cleanly in a
multi-column grid.
Event schedulesDate, time, event name, location. Each row is one event. Can be ordered chronologically
using the drag handles in the admin.
Portfolio entriesProject name, client, image, description, tags. Each row is one project. Renders as a
filterable grid.

What Should You Do Next?

Start with one simple repeater, such as testimonials, and get it showing on a page. Once that works, the same approach carries over to post templates and nested data. For a practical next build, follow our guide to creating a FAQ section with an ACF Repeater field.

Dynific Addons for Elementor

Display your repeater rows in Elementor

Turn any ACF Repeater field into a grid, carousel, accordion or tabs, designed visually without writing code.

Frequently Asked Questions

Is the ACF Repeater field free?

No. The Repeater field is part of ACF PRO and is not included in the free Advanced Custom Fields plugin. You need an active ACF PRO licence to create Repeater fields.

How many rows can I add to an ACF Repeater field?

ACF does not impose a hard limit on the number of rows. You can set your own maximum in the field settings using the Max Rows option. For very large datasets, consider whether a custom post type might be a better content structure than a Repeater with hundreds of rows.

Can I display ACF Repeater fields in Elementor without coding?

Yes. Dynific Addons for Elementor includes the DA – ACF Repeater widget, which lets you design the layout for one row visually and repeats it for every row. You can show the rows with the Default skin in a grid or carousel, as an accordion, or as tabs. No PHP is needed.

What field types can I use inside a Repeater?

Any ACF field type can be a subfield, including Text, Textarea, Image, File, Select, Checkbox, WYSIWYG, Link, Post Object, and even another Repeater field for nested structures.

Can I nest Repeater fields inside each other?

Yes. You can add a Repeater field as a subfield inside another Repeater. This is called a nested repeater and is useful for multi-level data like pricing tables, feature comparisons, or itineraries. Dynific Addons supports displaying nested repeaters in Elementor without code.

Can I use ACF Repeater fields on custom post types?

Yes. In the Location Rules section of the field group, set the rule to match your custom post type. The Repeater will then appear on every post of that type in the admin.

Can I show ACF Repeater fields on every post of a custom post type?

Yes. Create a single post template with Dynific Addons, add the DA – ACF Repeater widget to it, and each post shows its own repeater rows in the same design.

Can I reorder rows in an ACF Repeater?

Yes. Each row in the Repeater has a drag handle on the left side. Grab and drag to reorder rows. The order saved in the admin is the order they display on the frontend.

What is the difference between the Repeater field and the Flexible Content field?

The Repeater field repeats the same set of subfields for every row. The Flexible Content field lets you define multiple different layouts and add them in any order. For content where every row has the same structure, use the Repeater. For content where each row can have a different structure, use Flexible Content.

Does the Repeater field work with Elementor Pro dynamic tags?

Elementor Pro’s built-in dynamic tags do not support ACF Repeater fields directly. Dynific Addons for Elementor provides the DA – ACF Repeater widget specifically to handle this, giving you full visual control over how repeater data displays in Elementor.

What is the difference between the DA – ACF Fields V2 and DA – ACF Repeater widgets?

The DA – ACF Fields V2 widget shows a single subfield value inside your block layout. The DA – ACF Repeater widget loops through all the rows and displays the block layout once for each row.

Leave a Reply

Your email address will not be published. Required fields are marked *