---
title: "Field repeater form element"
date: "2020-08-19T10:01:06+00:00"
summary: "Easily create repeatable fields in your Site Studio components with the Field repeater form element. Learn how to set up, customize, and manage repeatable fields for enhanced form functionality."
image:
type: "page"
url: "/drupal-starter-kits/add-ons/site-studio/field-repeater-form-element"
id: "ee0ccd28-f8b1-4700-97ca-11ef8f6d0084"
---

Table of contents will be added

Use the Field repeater form element to provide users of the form with a way to repeat a field or multiple fields. For more information, see [Adding repeatable fields to a component](/drupal-starter-kits/add-ons/site-studio/adding-repeatable-fields-component "Adding repeatable fields to a component")

Locating the field repeater form element
----------------------------------------

To find the Input form element:

1.  Navigate to a component
2.  Click the **+ button** on the Component form builder
3.  Within the Fields tab, look for the Field repeater form element.

![f3bb85b0-field-repeater-form-element.png](https://acquia.widen.net/content/0e3715fd-be6e-42b4-889c-d5177c7141d5/web/f3bb85b0-field-repeater-form-element.png)

The Field repeater includes the following fields:

Field name
----------

*   **Field label -** Provide a name for the form element. **Important:** It will also be used to auto-generate the field machine name. Auto generation only occurs until you have clicked Apply.
*   **Machine name** \- Set the machine name of the field. Used as a token when linking an element to the field. Must be unique within the component. **Important:** If you need to change the machine name later, click the Edit icon on the field's right.

Field settings
--------------

*   **Minimum repeatable fields -** Set the minimum number of 'repeats'. For example, you may want a slider component that includes a minimum of 3 slides.
*   **Maximum repeatable fields -** Set the maximum number of 'repeats'. For example, you may want to limit the number images that can be added to a gallery component.
*   **Increment -** Set the 'repeats' to be added in increments that are different to 1. For example, you may want the number of slides added to a slider component to be added in sets of two because your slider relies on a even number of slides.
*   **Add button title -** Set the label on the button that's used to add another set of fields. 
*   **Sortable** \- Set whether the sets of fields within the repeater can be sorted using drag and drop.

Visibility
----------

*   **Show field if** - Enter conditional logic to show / hide the field based on the value of another field. For more, see [Component fields conditional visibility](/drupal-starter-kits/add-ons/site-studio/component-fields-conditional-visibility "Component fields conditional visibility").

Tooltip
-------

*   **Tooltip text -** Enter tooltip text here.
*   **Tooltip placement -** Define the position of the tooltip on hover of the field.