> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/field-types/input-fields/repeater.md).

# Repeater

Let a visitor add extra lines to one question, instead of guessing how many boxes to give them.

The field starts as a single input with a button underneath. Each click adds another line of the same input, so one visitor can list one item and the next can list ten.

> **📌 Plan:** Not available on the Free plan. The tile is grayed out in the element picker. See Plans and billing.

## 🔧 How to Set It

In the form editor, click **Add element** > pick **Repeater**.&#x20;

The field is added and its settings open on the left.

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2F31REWbzPr2SGyba9XtzN%2Fimage.png?alt=media&amp;token=a91a6b52-08cd-440e-b055-2e41c053dc3d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2FOQs76EUTBrZoemt2nWrL%2Fimage.png?alt=media&amp;token=4296261a-3314-41ef-8aea-ffdbd49cb9f0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
See [Add and arrange elements](broken://pages/BGbUu5Y7FlIp5LYqEwN9) for the other ways to add a field and how to reorder them.
{% endhint %}

## ⚙️ Settings

Only the settings specific to this field are listed here. **Label**, **Placeholder**, **Description**, **Required** and the other shared settings work the same on every field.

### **🔘 Button Label**

The wording on the button that adds another line. Default: **Add more**.

**Example:** A return form changes it to `Add another item`, so visitors know exactly what the button does.

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2FzxQtkrXCFIt9Axb7jeX0%2Fimage.png?alt=media&amp;token=38272a3f-36af-4fad-a7f7-8c378e588d62" alt=""><figcaption></figcaption></figure>

### **🔢 Limit Rows**

The most lines a visitor can add. Leave it empty and the app’s own ceiling of **20 rows** applies.

**Example:** A “Top three colors” question sets **Limit rows** to `3`. Once the visitor has three lines, the **Add more** button stops adding.

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2FqGwCYIlw3ngGBCoWcGDX%2Fimage.png?alt=media&amp;token=b1f84241-91dc-499f-b715-bb4cdf5a24d2" alt=""><figcaption></figcaption></figure>

> **💡 Tip:** Set a limit whenever a longer list wouldn’t be useful. Three lines on a “top three” question keeps answers comparable.

## 🔄 How It Works

```
Visitor fills the first line 
→ clicks "Add more" 
→ fills another line 
→ submits 
→ you receive all lines as one answer
```

All the lines arrive together as **one answer** under the field’s label. You don’t get a separate entry for each line.<br>

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2FV4bwVg0koQfulJmNRyTy%2Fimage.png?alt=media&amp;token=5a166a92-c1e8-4bb5-8e18-9ca6c381ef66" alt=""><figcaption></figcaption></figure>

## Next steps

* [Textarea](/field-types/text-fields/textarea.md) when one free-form box would serve better than a list.
* [Bulk order table](/field-types/input-fields/bulk-order-table.md) when the repeating thing is products and quantities.
* [View submissions](/submissions/view-submissions.md) to see how a repeated answer is recorded.
