Repeatable section buttons

REPEATABLE SECTIONS – EXPLANATION

Repeatable sections allow users to enter the same set of fields multiple times within a form. This is useful for scenarios such as adding multiple contacts, locations, attachments, or other repeating data.

When a section is configured as repeatable, the user is provided with buttons to manage these repeats.


REPEATABLE SECTION BUTTONS

When a section is set to be repeatable, the following buttons are available to the user:

  • Add – add a new repeat below the current one

  • Copy – copy an existing repeat into a new repeat

  • Delete – remove a repeat

Best practice: Place the repeatable section buttons as the last field inside the repeatable section.


TRANSLATIONS

Repeatable section buttons require translations. These translations are configured via the Labels input and define how the buttons are displayed to the user in different languages.


HOW TO CONFIGURE A REPEATABLE SECTION

Step 1 – Enable Repeatable on the Section

Open the Section settings and enable the Repeatable checkbox.

You can configure the following options:

Setting
Description

Initial repeats

Number of repeats shown when the form is opened

Minimum repeats

Minimum number of repeats that must exist. Leave empty for no minimum

Maximum repeats

Maximum number of repeats allowed. Leave empty for no maximum

Add more repeats increments by

Number of repeats added at once when clicking Add


Step 2 – Example Configuration

Setting
Example
Explanation

Initial repeats

2

Two repeats are shown when the form opens

Minimum repeats

4

At least four repeats must exist

Maximum repeats

8

No more than eight repeats are allowed

Add more repeats increments by

5

Clicking Add adds five repeats at once

Note: When the maximum number of repeats is reached, the Add and Copy buttons are no longer visible. If one repeat is removed, these buttons become available again.


Step 3 – Add Fields to the Section

Place all fields that should be repeatable inside the repeatable section. All fields inside the section are automatically duplicated when a new repeat is added.


Step 4 – Add the Repeatable Section Buttons

As the final field within the section, add a field of type Actions and select Repeatable section buttons.

This enables the Add, Copy, and Delete buttons for the section.


SEPARATOR IN A REPEATABLE SECTION

A separator can be used to visually separate each repeat for the end user.

The separator is configured as a Section-type field and placed inside the repeatable section. Because it is part of the repeatable section, it is evaluated for every repeat.

To prevent the separator from being shown before the first repeat, a section condition is applied:

  • System variable: #REPLACE-REPEATABLESECTIONINDEX-zero#

  • Operator: >

  • Value: 0

This ensures that:

  • No separator is shown for the first repeat

  • A separator is shown for all subsequent repeats

The separator section typically contains a Static HTML field that renders a visual divider.


RESULT FOR THE END USER

  • The form opens with the configured number of repeats

  • Users can add, copy, and remove repeats

  • Minimum and maximum limits are enforced

  • Each repeat is clearly separated for better readability

Last updated

Was this helpful?