---
title: FORM Butler – Web Form Dynamic List Element
description: "### **What is a Dynamic List?** **Component Overview:** Dynamic List is a component in the form that allows you to: - Add multiple records - Edit them - Delete them *Example: list of Contacts, Products, Invoices, etc.* ### **Setup in…"
url: "https://pdfbutler.com/academy/form-butler-academy/form-butler-web-forms/form-butler-web-form-dynamic-list-element/"
updated: "2026-03-26"
category: Web Forms
---

# FORM Butler – Web Form Dynamic List Element

### **What is a Dynamic List?**

**Component Overview:**
 Dynamic List is a component in the form that allows you to:

- Add multiple records
- Edit them
- Delete them

*Example: list of Contacts, Products, Invoices, etc.*

### **Setup in the Editor**

**Step 1: Go to the Editor**

Add and set up the component in the Editor. Go to the Editor.

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture1-1.png)

 

**Step 2: Add the component**

Add the 'Dynamic List' component to the layout.

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture3.png)

**Step 3: Data Sources & Object API Name**

Set up Data Sources and the Object API Name for the Dynamic List.

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture4.png)

**Note:***You can only use a Data Source with Record Type = List of sObjects.
 Also, only one Data Source with Record Type = List of sObjects can be used on the form.*

**Step 4: Add components inside**

You can add other components inside the Dynamic List. For example, a Text Field component.

When configuring it:

- The Data Source must be the same as the Dynamic List (Record Type = List of sObjects)
- Set the correct Field API Name

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture5.png)

Note: You cannot use the Attachments component in a Dynamic List.

Instead, you can use the Multiple Documents component.

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture6.png)

### **Dynamic List Logic — Default number of items + Allow add/delete items**

**Allow add/delete = TRUE**

**Default number of items = 0**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture7.png)

 

 

 

The Viewer will display:

- All existing records (from prefill)

Additionally:

- The "Add new" button is available

User can:

- Add new items
- Delete items

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture8.png)

**Allow add/delete = FALSE**

**Default number of items = 0**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture9.png)

 

 

 

The Viewer will display:

- All existing records (from prefill)

However:

- The "Add new" button is NOT available

User:

- Cannot add new items
- Cannot delete items

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture10.png)

**Default number of items > 0 (e.g. 1, 2, 3…)**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture12.png)

Regardless of Allow setting, the Viewer will display:

- all existing records (from prefill)
- + additional empty items based on Default value

Examples:

- Default = 1 → all existing records + 1 empty item

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture13.png)

### **Dynamic List Collapse Logic**

**Collapse setting**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture14.png)

 

 

**Disable collapse = TRUE**

All items in the Viewer are:

- Expanded (not collapsed)

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture15.png)

**Disable collapse = FALSE**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture17.png)

Items in the Viewer are:

- Collapsed by default

Only a specific number of items remain expanded based on:

**Number of non-collapsing items**

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture18.png)

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture19.png)

**Number of non-collapsing items**

Defines how many items stay expanded. The rest of the items will be collapsed.

Examples:

- Value = 1 → only 1 item expanded, others collapsed
- Value = 2 → 2 items expanded, others collapsed

| Minimum value is always 1. If 0 is entered, the system throws an error. |
| --- |

![](https://pdfbutler.com/wp-content/uploads/2026/03/Picture20.png)

### **Final Step**

**Generate a Form Request**

After completing the form setup in the Editor, you can go to the record and generate a Form Request.