How to Set Up the Configurable List Widget

June 19, 2025

The Configurable List widget allows you to define and display a set of fields or questions that users can duplicate as needed. This is ideal for cases where a respondent needs to answer the same set of questions multiple times. For example, entering information for multiple people, items, or tasks.

Adding and Setting Up the Configurable List Widget

Adding the Configurable List widget to your form and setting it up is pretty simple. Here’s how to do it:

  1. In Form Builder, click on Add Element on the left side of the page.
Add Element button in Jotform Form Builder
  1. Now, in the menu on the left, under the Widgets tab, click on Configurable List widget to add it to your form.
Configurable List under Widgets tab in Form Builder
  1. Next, in the Widget Settings menu that opens on the right side of the page, set up the following things:
Configurable List widget settings open in Form Builder
  • Minimal Rows Number — This is the number of Rows to be added by Default.
  • Maximal Rows Number — Use 0 to allow unlimited rows. This number must be equal to or greater than the minimal row number.
  • Label for Add — Optionally customize the Text to show on Add button. 
  • Single Line — Toggle this On to see all fields in a single line per each row.
Configurable List settings showing minimal and maximal rows, Add button label, and single line option
  1. Now, click on Update, and you’re all set.
Clicking Update button to save Configurable List widget settings

Curious about how it works? Check out this demo form to see it in action.

Supported Field Types and Syntax for the Configurable List Widget

The Configurable List widget supports a variety of input types, allowing you to dynamically collect different kinds of information on your form. Here’s the complete list of supported field types and the syntax you can use to add them:

Note

Each field declaration must be placed on a new line for it to work correctly.

Let’s take a closer look at the syntax for each supported field type below:

Text

Use this for basic single-line responses like names or email addresses.

Syntax:

 Label: text[:placeholder]

Examples:

  • Name: text
  • Email: text: Type here…
Form Configurable List widget Text Sample

Number

Use this to collect numeric inputs such as age, quantity, or ratings.

Syntax:

 Label: number[:placeholder:step,min,max]

Examples:

  • Quantity: number
  • Age: number: Enter your age
  • Rating: number::1,1,10
Form Configurable List widget Number Sample

Text Area

Use this for longer responses like notes or comments.

Syntax:

Label: textarea[:placeholder]

Examples:

  • Comments: textarea
  • Feedback: textarea: Type your feedback…
Form Configurable List widget Text Area Sample

Dropdown

Use this to allow selection from a list of predefined options.

Syntax:

Label: dropdown: option1, option2, option3[:defaultOption]

To have one of the options selected by default, replace the placeholder with one of the options on your list. Examples:

  • Pizza: dropdown: Cheese, Pepperoni, Sausage
  • Size: dropdown: Small, Medium, Large: Please select
  • Drink: dropdown: Apple, Orange, Pineapple: Orange
Form Configurable List widget Dropdown Sample

Radio Button

Use this for single-choice options displayed as radio buttons.

Syntax:

Label: radio: option1, option2, option3

Examples:

  • Order Type: radio: Pick-up, Delivery
  • Vegetable: radio: Carrot, Radish, Broccoli
Form Configurable List widget Radio Button Sample

Checkbox

Use this for multiple-choice options. Users can select more than one.

Label: checkbox: option1, option2, option3

Examples:

  • Add-ons: checkbox: Soda, Salad, Fries
  • Sauce: checkbox: Sweet, Sour, Spicy
Form Configurable List widget Checkbox Sample

Date Input

Use this to show a calendar date picker.

Syntax:

Label: dateInput[:format]

If the date format is undefined or invalid, it defaults to y/m/d. You can rearrange the format if you want it.

Examples:

  • Date: dateInput
  • Date of Birth: dateInput: m/d/y
Form Configurable List widget Date Input Sample

Time Input

Use this to let users select a time value.

Syntax:

Label: timeInput:format[,now]
  • The allowed format values are 12 (with AM/PM selector) and 24. If invalid, it defaults to 12.
  • To set the current time as default, append “,now” to the declaration.

Examples:

  • Appointment Time: timeInput: 24
  • Current Time: timeInput: 12,now
Form Configurable List widget Time Input Sample

Date

Use this to display date selection in dropdown format (month/day/year).

Syntax:

Label: date[:format:range:today]
  • If the date format is undefined or invalid, it defaults to y/m/d. You can rearrange the format if you want it.
  • The year range is formatted as start–end (e.g., 2015–2025). If you don’t set it or enter something invalid, it defaults to a range from 10 years ago through to 1 year from today.
  • To set the current date as default, append “:today” to the declaration.

 Examples:

  • Date of Birth: date
  • Event Date: date: m/d/y: 2025–2030
  • Date: date: d/m/y: today
Form Configurable List widget Date Sample

Time

Use this to show hour/minute/AM-PM dropdowns.

Syntax:

Label: time[:format,now]
  • The allowed format values are 12 (with AM/PM selector) and 24. If undefined or invalid, it defaults to 12.
  • To set the current time as the default, append “,now” to the declaration.

Examples:

  • Arrival Time: time:12
  • Current Time: time:12,now
Form Configurable List widget Time Sample

Static

Use this to add read-only notes, hints, or instructional text between fields.

Syntax:

Label: static: [text]
  • Supports basic HTML for formatting.

Examples:

  • Note: static: We are open 24/7.
  • Tip: static: Click on the <strong>Add Row</strong> button to add more.
Form Configurable List widget Static Sample

Making Configurable List Fields Required

To make a field required, add an asterisk (*) at the beginning of its declaration. This ensures that users must fill out the field before submitting the form.

Examples: 

  • *Name: text
  • *Date of Birth: date
Form Configurable List widget Require Fields Sample

Customizing the Appearance of Your Configurable List

You can customize the appearance of your list to match your brand, product style, or corporate identity. The Configurable List widget supports custom CSS, giving you full control over its look and layout.

  1. In Form Builder, select your widget and on the right side of it, click on the Wand icon.
  2. Then, under the Custom CSS tab, paste in your CSS code.
  3. Now, click on Update, and you’re all set.
Pasting custom CSS in the Configurable List’s Custom CSS tab
Introducing Jotform Shopify
Contact Support

Our customer support team is available 24/7 and our average response time is between one to two hours.

Send Comment:

Jotform Avatar
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Comments:

  • Solbena Nsolotshi - Profile picture
  • Hugo Junior - Profile picture
  • yoeri caous - Profile picture
  • David Bols - Profile picture
  • Steve Rush - Profile picture
  • Dana M Stillwagon - Profile picture
  • Bob Chapman - Profile picture
  • Luan Martins Silva - Profile picture
  • Grade Electricals - Profile picture
  • JustinandSue Harvey - Profile picture
  • Mohammad Zabal - Profile picture
  • Ally - Profile picture
  • Sarah Lindsay - Profile picture
  • Hector Garcia - Profile picture
  • Sebastian Grote - Profile picture
  • Julia - Profile picture
  • Addaline App Services - Profile picture
  • Formularios Juntos - Profile picture
  • Brittany Castellano - Profile picture
  • cricketsports - Profile picture
  • College Settlement - Profile picture
  • Regius Sports - Profile picture
  • Diamandis Diamandiss - Profile picture
  • Diamandis Diamandiss - Profile picture
  • Diamandis Diamandiss - Profile picture