JotForm User Guide / Advanced Features /

How to Set Up the Configurable List Widget

How to Set Up the Configurable List Widget


The Configurable List Widget requires a little more to set up, but its not hard at all. 

There are a few things we need to consider in order to understand how it works and get the widget up and running: 

          • 1. The Widget dynamically adds a set of fields on your form as a list
          • 2. You can add as many rows as possible
          • 3. You can define the type of data or information that can be collected for each dynamically added row on the list
          • 4. To restrict the type of information that can be collected, you need to define field types
                • 5. The following field types are allowed in the configuration for each row on the dynamic list:
-Text Area
-Drop Down
-Check Box
-Radio Buttons
-Static - Display a Message or Text

How to Configure the Widget

The Configuration Dialog opens when you add the widget to your form. You can always access it by clicking the  widget's wizard wand from the form builder:

We have prepared a Table that will guide you in setting up your dynamic list through this widget: 

Lets begin with the List Field Configuration: 

Field Type

What it Does

Field Configuration - How to add this field as part of the list with available options



Accepts plain text

Field Label:text : Hint Text



Accepts Numbers only

Field Label:number


Text Area

Accepts more Text in paragraphs or narrations 

Field Label: textarea : Hint Text

Comments : textarea : Hint Text


Check off available options

Field Label: checkbox: option 1, option 2, option 3

Payment: checkbox: Full, Partial

Radio Buttons

Select one of the available options

Field Label: radio: option 1, option 2, option 3

Accept Terms? : radio: Yes, No


A list of Options in a Drop Down List

Field Label: dropdown : Option 1, Option 2, Option 3, Option 4 : Hint Text

To have one of the options selected by default, just replace it with one of the options on your list, for instance: 

Field Label: dropdown : Option 1, Option 2, Option 3, Option 4 : Option 2

Where Option 2 Will be selected by default when the form is opened. 

Title: dropdown: Mr, Mrs, Miss, Dr, Prof. : Select One


A Date Selector with a pop - out calendar

Field Label: date : m/d/y : 2014 - 2034

If the date format is undefined or invalid, it defaults to y/m/d. You can interchange the letters as you wish

Years' range - formatted as start-end, e.g. 2005-2015. If undefined or invalid, defaults to a range of ten years ago from now to next year from now

Date of Arrival: date:m/d/y:2014-2020


A Time Selector

Time: time:12

Time format - allowed values are 12 (with AM/PM selector) and 24. 

If undefined or invalid, it Defaults to 12.

To Set Default Time, add " ,now" to config. i.e., 

Arrival Time: time : 12, now

Arrival Time: time : 12, now


Display some Text

Field Label: static: The text you want to display

Important Message: static : Click on the '+' button to add a new row.

The Table above looks a little scary, however, its quite easy. Here is a sample configuration: 

This is what the configuration will show on your form: 

After completing each field configuration, hit the return (enter) key to add a new field configuration on a different line so that the widget can treat it as a new field setting. 

Other Configurations

To Limit the number of rows that will be added on your form, enter the number in the Maximum Rows Number input Box. 

To automatically load the first row (or more),  enter the number in the Minimum Rows Input Box. 

To change the buttons text (add row and delete row), you can define it in the following input boxes: 

Set a Field or Input as 'Required'

In most forms, some fields should not be skipped, like names and email fields. To prevent the form user from skipping these non-optional fields, you need to set the field as 'required'

To complete this setting, all you need to do is add an asterisk (*) before the field configuration as shown below: 

Your form users will only be allowed to submit the form if those fields are completed: 

Change How The List Looks

Its often necessary to style your form to look exactly how you would like - perhaps to match your product image, or corporate identity among other reasons. 

With this widget, you can further customize how the list looks by adding custom CSS. 

And here is an example form: 

You are welcome to clone/copy the form; take a closer look or modify the form as your own. 

The Custom CSS part can look a little too technical - but not to worry - we would love to help - just let us know

That's all it takes to configure the widget. 

If you want to make the Configurable List Widget mobile responsive, check this guide How to Make the Configurable List Widget Mobile Responsive

We would love to hear what you think, or share your experience so that we can continually improve the tools that make your form awesome! 

Contact Support:
Our customer support team is available 24/7 and our average response time is between one to two hours.
Our team can be contacted via:
Contact JotForm Support:

Send Comment


See all comments
  • Green_Louise

    Can you specify that a field is classified as text only so it is not added in a subsequent calculated field

  • yavuzselcan

    How can I add "Other" text field for the dropdown? I want to add "Other" option into the dropdown menu and get the details instead of "Other" with a text area.

  • MarianaCCForm

    Good day, is it possible to put a entry limit to the number of letters they use in a textarea?

  • Camila_Zambrano

    Hello! it is possible to have in the 1 column a checbox list with diferent text per row and in the 2 column a date and in the 3 column a drowdown list?

    I hope you can understandme my english is not really good!
    Nice Day,

  • houndandbone


    Is there a way to stop the Quantity field from being able to display negative numbers?
    Thank you!

  • Aalgse

    The configurable list cannot be disabled via conditions whilst other fields can, please correct this ability to align with the disable condition rules (and make it a general abiliy/requirement of any widget/field implemented. thankyou

  • wamco_reg

    Hi, how can i add some javascript to the widget? For example, to enable some calculations etc. when a field in the widget changes. And can a class value be added to the fields with an auto increment with each row like -. This could help in doing some javascript activities.

    Thank you

  • HuttonSafetyGroup

    Do you think it'd be possible for you guys to develop an "add photo" upload? For example, we complete inspections and right now the inspection columns on the configurable list are just "list the defect, give notes, etc." but I'd love to be able to have a "Take Photo" option relating to that row on the configurable list. Because then they can add as many defects or lines as possible.

    Thanks for considering it!

  • citylock

    anyway to remove the " Label for Add " and the "Label for Remove" I don't want the user to be able to add or remove anything

  • sbitforms

    Can I define the width of the text columns? Defining the width of the whole widget in CSS only seems to influence the width of a checkbox column (and maybe radio button column, but I do not use that one)

  • acgofamericas

    Is there a way of creating a dynamic field, that starts woith Number 1, and as the user adds the (+ Row), the additional Row, shows now the Number 2? To identify the number of rows automatically

  • phoenixsolarsa


    Is there a way to do away with the 'add row' button in the Configurable List Widget?

  • pricelesspendantz585


  • cpdoperation

    Hi, i'm trying to use this menu, on the form builder is quite easy, but is there any way to download the result into CSV or Excel, becasue it's lump up into 1 cell for all instead of 1 cell for each so its difficult to compile


    Hi, Im using this as a set menu option (one configurable line only). Each set menu is $3. How can I set a value to this widget = 3 if the checkbox in the first column is selected? This is so i can calculate total order amount at the end of the form.

  • GeorgSoller

    hi, ist ist possible zu fill the ist row by URL?

    like this:

  • BoldVenture

    Is there a method of hiding the field name in the configurable?

    Instead of Author: Mike Smith; Title: "Name of Story" ...

    I'd like to get it into excel as:
    Mike Smith; "Title of Story"

  • FosterJames

    Is there a way to do an email and phone number input mask in the text or number fields?

  • Jorgia

    The configurable list won't let me make certain fields in the list required as you've mentioned above. I've done this before and it worked just fine - but when I'm doing this in the form I've listed, their red asterisks won't appear. What am I doing wrong?

  • cnbcf

    Is there a way to display month description in other language instead of english one in date type fields? As alternative, could be displayed just numbers. (Ex.: 01/01/2020)

  • XplatformKSA

    how to make a calculation table using configurable list

  • ekgaevents

    Hi On my configurable list .. i am looking to make the text boxes smaller to make all options fit on the page better. I cant figure out how to do this.. can you help me please

  • studentservicespt

    Hi, how do I add limits in the 'Date'? I'd like only dates that are 2 weeks from today to be selected.

  • DarkroomRefinery


    I would like to change the fields' font color so that it matches the rest of my form elements.
    Is there a way to do this?

    Thank you

  • orbin

    Configurable Widget
    Q: "How to format the widget rows into an "ordered list" (1,2,3,4...) shown in static text"

    1. [textbox][dropdown][date]
    2. [textbox][dropdown][date]
    3. [textbox][dropdown][date]

    Desired result:
    * +/- ADD/DEL = The number listed would increase/decrease - based on the user's action.


  • gforceforms

    Hello, Is there a way to better separate to data within the excel export. Current result below

    [Quantity: 15, Month: 7, Year: 19Quantity: 8, Month: 6, Year: 19]

    Currently no separation of the two sets of data

  • QCECDataCollections

    Can we put 11:00AM as the default time instead of "now" as the default value of a time field?

  • mattssei

    Is there any way to carry over the date from the previous line to the new line - so we're not entering the date for each line?

  • QSESolutions

    Can you configure a calendar within the widget to be a fixed date or configurable date without manually selecting the mm/dd/yyyy?

  • avristhr

    can we set the date field only for YEAR & MONTH without DATE?

  • refugeehandicarfts

    How can get Total Calculation Value At The End

  • ABSDigitalTeam

    I'm trying to minimize the width of each column since it's going over the form size, I already tried:
    input[type="text"] {

    width: 150px !important;

    td.col2 > input {

    width: 200px;

    (this one I tried for every column as well (ex, td.com1, td.co2, etc))
    I pulled both of these from other answers here but they're not working for me, can you please give me some guidance?

  • levidasesor

    How do I put the Input as 'Required' in my form , IT SAYS WITH * Just it should do it but it wont go.

    Example: *Label:Label text: asda (nothing happens)

    I tried with, Example: '*' Label:Label text: asda (nothing happens)

  • Jon

    Responses exported to google sheets are populated all in one cell. Is there a way to parse the response such that each field is a column and each row and one row in the configurable list?

  • BringitonSports

    Is there a way to default the Date and Time to the current date and time?

  • graymontHR

    Is it possible to change the width of each text and text area field? I'm a rookie with CSS.

  • nbomfs

    Custom CSS Tab not available

  • miguelben

    Can I specify a correct answer? For a quiz for instance, I'd like to let the user know if their answer is correct or incorrect.


    I'm using a "input table properties" widget and want there to be a condition that if the first column has a value, the second column also requires a value- is this possible? I can't find a way to configure it

  • VisAbility6100

    I can apply custom CSS to our form including the add/remove buttons however cannot get the hover attribute to function correctly. Can you provide any advice?

  • CopernicanCoach

    I've used CSS to configure the layout of the form.
    My issue is the data on submission remains in compressed column form, and I'd like the submission to reflect the form layout. (Multiple lines, easy to read and follow rather than tight columns.

    How do I get the final form upon submission to read like the input page? The form is emailed to the client upon submission and it is unreadable due to all the answers populating a columnar grid.

  • CopernicanCoach

    I've used CCS to configure the layout of the form. My issue is the data on submission remains in compressed column form, and I'd like the submission to reflect the form layout. (Multiple lines, easy to read and follow rather than tight columns.

  • Focux

    Hola como estan, puedo cambiar los meses al idioma español?

    Muchas gracias!

  • Jordan Callihan

    Can I add a total, if I am using the list as a time sheet.

  • achieveeducation

    Is it possible to add links within the text of a checkbox? If so, would it affect the mobile responsive custom CSS if I want my fields in the card to go to different lines?
    Many thanks.

  • projectofficer

    Hi, love this widget!
    Is there any way to have a line break in the static content, similar to

    For example, I would like the static content to display:
    Fire Extinguisher

    Currently, all I can enter is:
    Control : static : Fire Extinguisher, PFD, Flares
    This shows the Control items as a single row, which looks messy.

    And no, I do not want to insert new configurable lists for each item, as I have other columns after the static column.

    Is it possible please?

  • lokita_daki

    Hello, I don't see the custom css tab when I am in the widget settings. How can I configure the css? Thanks

  • OPS_EE

    Is it possible to add in a image upload option into the configuration list? If so, how?

  • Grimaldi_Anthony

    If I am doing a column as a rate and multiple choice for amount of hours is there anyway I can configure the total ?

  • CariadBabi

    I would like to limit the time range similar to the date range, to be between 9am and 5pm, how can I do this?