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. 

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! 

Send Comment


See all comments
  • WelcomeBookatable

    Hello there,

    I have implemented the widget to give users the ability to add a series of dates. However, we are now using the form in different countries and were wondering whether the months within the calendar could be translated into other languages? We've added translations via the Settings tab, but they are not being picked up by the widget & I can't see a way to stipulate other languages in the widget settings.

    Is this possible?

    Look forward to hearing from you soon!

  • grs.ami.19

    Is it possible to make one checkbox option a text field that a client can type in an option not listed?

  • grs.ami.19

    How can I remove the add button?

  • jaya.rupanagudi

    Could we add conditions on each of the fields in the configurable list?
    eg. If user selects the radio button 1, then the drop down would show a set of options, if option 2 is selected, a different drop down is shown.

  • jaya.rupanagudi

    Could we add conditions on each of the fields in the configurable list?
    eg. If user selects the radio button 1, then the drop down would show a set of options, if option 2 is selected, a different drop down is shown.

  • moulot

    the "Add Row" button Label keeps showing "Add Row" no matter what it's typed in the Label for Add.
    customized with : "+ Add". i get "+ Add Add Row".

  • Emgsupport

    How do I add multiple text fields / multiple calendar fields?

  • SavannahMenu

    How do I add a "Browse Files" button to this so my client can upload a photo?

  • MohawkClaims

    How to do I change the color of the text?

  • FracoMercadeo

    Como ocultar texto del desplegable?

  • GlobalFormations

    Custom CSS does not appear on this widget.

  • RickyRampersad

    Not seeing it on my site

  • TinyTerrors


    I am wondering how to adjust the date times within the configuration list widget - ie; max past date and max future date. At the moment the form only allows the year 2009 as the earliest year to be born.

    Thanks! :)

  • WelcomeBookatable

    Is there a way to remove the 'Add' button
    I just want a static list, and one that I can have pre-ticked (I'm using the checkboxes exclusively) if possible

  • RCBM

    How do I configure the time field to show no default time?

  • Rowenarabbit

    I cannot do it. I’ve tried all week. Is there anyway I can pay someone to help me out. You keep sending me emails but I just don’t understand anything.

  • MyKyokushinkan

    Hi, may I know is there a way to retreat the number of rows so that I can perform some dynamic calculation on the fly?
    Thank you!

  • soneaf

    Hello there ... I am using the Configurable List Widget and would like to turn off all the tool tips/hover over help that pop up. Is this is possible, I am having a hard time finding this option.
    Here is a link to a screen grab of what I am tryin to get rid of.
    Any help would be great.

  • drdavidkerr

    Is there a way to error check a text field? In this case I want a 5 digit Zip code and I would like it so there is only 5 digits allowed and ideally only numbers.

  • yu

    The second and subsequent static will not be reflected.
    The first static will be listed in the outgoing email.
    How can I change the display?

    ・Fields configuration
    : dropdown : , 1, 2, 3, 4, 5, 6, .......12
    : static : month
    : dropdown : , 1, 2, 3, 4, 5, 6, .......31
    : static :day

    1 month 22 month

  • hr587

    Is it possible to make the dropdown calendar start on Sunday instead of Monday?

  • Tournure

    When i linked the results of my form from the Configurable List, there is just one column with all the results. Is it possible to be export in different column for each question ?

  • finola123

    When using the drop down list option in the configurable list is it possible to have the options that you've search for move to appear at the top or closest to the search box?

  • akuns123

    Trying to create different questions for each row - but it won't let me add a new row
    Tried added or and still not allowing what I'm looking for

    Do you have a financial planner?: Yes/No - If Yes, who? _________
    Do you have an insurance professional?: Yes/No - If Yes, who? _________
    Do you have a CPA/Tax Preparer? Yes/No - If Yes, who? _________
    Do you know of a family member, friend or associate that is in need of a mortgage professional? Yes/No - If Yes, who? _________


    i was trying to link docusign and twilio to the form, but it always showed me something is wrong. can you teach me how to do it? Thank you!


  • casavolunteer

    Please let me know if using the configurable list widget, if there is an option to include a calculated field.

    Thank you,

  • supplychainMIS

    Following the recent update to the PDF designer, the content that had been entered such as text in a text box, now only shows the column header, not the free text that has been input.
    Please advise.


  • popfolio

    How do I build a checklist of 10 different numbered descriptions (static text) with each item that requires 3 columns of checkboxes (for eg. Yes / No / Maybe) and 1 column for remarks (text)?
    Item Yes No Maybe Remarks
    1. aaa
    2. bbb
    3. ccc
    Seems from some of the comments below, line breaks are very much in demand for this widget. Pls find a way to include it.

  • ChiryokuRyu


    im trying to make a register; with a checkbox for attendance and a textbox for additional notes

    but i cant put different names on multiple rows :(

  • Pete36

    How do I insert line breaks. I want my form to have boxes as follows:

  • Justjade

    i LOVE THIS widget, finally something that covers everything! However, even with your example form, the boxes overflow. Is there a way to make the selection smaller (smaller text, wrap text?) to fit the full box onto the page?

  • uncbd

    For the 'Number' field box, is there a way to exclude negative numbers?

  • indospirit

    I want to validate the email field in this widget. How it can be done? Anyone, please suggest?

  • KarFre

    I've already reviewed the instructions on how to setup a configurable list and those instructions do not address how to limit/restrict/format the number entry field. I need to restrict commas in dollar amounts and include a dollar symbol. Right now I have some users entering commas, and others who are not. This is problematic when exporting the data for analysis and I need to make the entries consistently formatted. Can you help?

    Here's my original question:
    Is it possible on the number field to have it automatically enter a $ sign and comma for dollar amounts such as $500,000?

  • KarFre

    Is it possible on the number field to have it automatically enter a $ sign and comma for dollar amounts such as $500,000?

  • noidifercam

    would it be possible to integrate the "autocomplete" function in one of the fields?
    I know there's a dedicated widget for this function, but we need a dynamic matrix.
    The configurable widget is perfect, it only lacks this smart search kind of function for long lists (of names in our case).
    Thank you!!

  • PTD_180

    I need to remove the "Add" button.
    how can do this?

  • VpC2018

    I'm not able to have personalized CSS to work
    I add the following:
    .textarea {
    margin: 10px;
    width: 130px;
    whatever number I use the text area is always the same form (asx without personal CSS).
    Thanks for any help

  • ESFA

    Can you set the width of a column using CSS?

  • ESFA

    Can you have the Radio Buttons in multiple columns?

  • pjwindow

    Everything shows up on the website, looks great. When it's filled out it works and shows up on Jot Form but doesn't get sent in the Email. What am I doing wrong??

  • OnlineDressageEntries

    This is nowhere near flexible enough for what I need. You MUST update this widget to remain competitive. For my project, multiples of the same thing are a core function, and I have 20 fields which may need to be duplicated in one large block. Dealing with the configurable list Widget is clumsy and inefficient... and it look awful and amateurish.
    Despite, the many great widgets that you offer, this one is so bad, and so important to my project that unfortunately I will have to use Cognito for their much better 'repeating section', despite their lack of flexibility around styling and so on.

  • SysCloudUS

    I love this - is there any way though I can make the entries more grouped instead of a big long row?


  • buffalotours

    HI team - I can't sort out how to narrow down the width of the configurable list? On desktop it appears fine, but it does not resize to mobile well, and the item is broken in the survey. Any advice on how to insert a "line break" in the configurable list?

  • bellajeannephoto

    Hello! I'd like to list products by category, then size. I want check off the size, and next to it have quantity of that product on that line. How would I do that? For instance it would look like this:


    Size Checkboxes: Quantity Dropdown
    8x8 1-5
    8x11 1-5
    10x10. 1-5
    12x12 1-5

  • gcfohl

    Hi there,
    How do I pass values via the URL to pre-fill form fields in the configurable list?


    This configurable list is Awesome. But, is there any way to move the "add" button to the same line (row) as the textbox fields? And subsequently for any "added" row for both the "add" and "remove" buttons to be side by side on the same rows also?

  • dirtydozen

    fantastic tool! how can i configure the width of any field? is it possible?
    tnx Alex

  • Fox_44

    Is there a way for me to ensure that only unique entries will be accepted in the number field?

  • canadaborderlaw

    I just want to use the Month and year of Date?