Creating Repeater Groups
How Repeater Groups Work
A repeater group is defined by a Start marker and an End marker. Any fields placed between these two markers become repeatable as a group.
When a user clicks “Add Row” on the frontend, the entire group of fields is cloned — with proper naming, validation, and conditional logic applied to each row.
Adding a Repeater Group
- In the form editor, go to Advanced Fields
- Click Repeater Group
- Both a Start and End marker are added automatically
- Drag fields between them
The form editor shows a visual boundary (dashed blue outline) around the fields in the group.
Group Names
Each group has a unique name (e.g., passengers, line_items). Auto-generated from the field ID but editable. The name is used in:
- Entry meta:
gfr_rows_{groupname} - Merge tags:
{gfr_rows:groupname} - REST API:
gfr_rowskey (Pro) - CSS targeting:
[data-group="groupname"]
Duplicate group names are prevented — the editor shows an error if you try to reuse a name.
Multiple Groups
Pro Feature: Multiple repeater groups per form require a Pro license. The free version supports one group per form.
Each group operates independently with its own settings, row count, and button labels.
Multi-Page Forms
Repeater groups work on multi-page forms. Place the Start and End markers on the same page — a group cannot span multiple pages.
Paired Deletion
When you delete a Start marker, its matching End marker is automatically removed.
Tips
- Keep groups focused: 3-6 fields per group works best
- Use Section Break fields inside groups to organize fields
- Use descriptive group names — they appear in entry meta, merge tags, and the API