> For the complete documentation index, see [llms.txt](https://docs.smt-x.com/smtx-online-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smt-x.com/smtx-online-documentation/fulfillment-platform/forms/repeatable-section-buttons.md).

# 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