How to Use the Spreadsheet to Form Widget

June 23, 2022

Are you hoping to populate your form fields from an external Excel Sheet? Perhaps you wanted to pull existing records and display them on your form? If so, your long wait is over. Meet the new Spreadsheet to Form widget.

The widget allows you to upload a spreadsheet to your form and use the values you have on the spreadsheet to pre-populate the form. By using a unique code present on each row of your spreadsheet, you can access that specific row when it matches the unique code entered on the form. Think of it as querying a database using the unique code as the key index.

Requirements and Limitations

Before we proceed, here are some limitations and key points you should be aware of:

  • The widget requires XLS, XLSX, or CSV files; it won’t accept any other format.
  • The unique code on your sheet doesn’t necessarily need to be on the 1st column. You can place it anywhere for as long as you configure the widget with the respective column index (more on this later).
  • The unique code is case-sensitive.
  • The column names on your sheet should match the field labels on your form.

For example, if your form fields were labeled like this:


Then, the column names on your sheet should be labeled exactly the same.


Here’s the demo form and sample spreadsheet used in the setup above.

  • The arrangement of the form fields on your form won’t matter even if you have other fields in between. What’s important is to ensure that the form field labels and spreadsheet column names match.
  • The widget only supports the following form elements:
    • Full Name
    • Email
    • Time
    • Short Text
    • Long Text
    • Dropdown
    • Single Choice
    • Multiple Choice
    • Scale Rating
    • Star Rating
  • When the unique code is correct, the values inside the fields to be populated will be cleared and replaced by the values fetched from the spreadsheet.

If everything above looks good, let’s get on with it!

Setting up the Widget

  1. Click the Add Form Element button in the Form Builder.
  2. Go to the Widgets tab.
  3. Search and select the Spreadsheet to form widget.
  1. Click the Upload File button in the widget’s settings panel.
  2. Upload the spreadsheet file.
The bigger the file, the longer it will take for the data to load on the form.
  1. Set the Access code column and Label row options.

Access Code Column

The unique code column index. This will help identify each data row you want to appear on the form. Say, your unique codes are placed on Column K in Excel, then you type in “K” in this field.

Labels Row

The column labels‘ row number. Also known as the column headings that are usually on the first row. This will identify each column label and fill in the exact question label from your form. The same idea applies if your column labels are on row 1, then type in “1” in this field.

Autofill By Condition

Enabling this option allows the widget to autofill the fields without clicking on its fill button if the widget’s input field gets a value through the conditions. Here’s a demo form to see it in action.

The other options, Fill Button Text, Loading Message, etc., are relatively straightforward.

Questions? Don’t hesitate to post them in our Support Forum.

Was this guide helpful?
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:

Support Forum:

Contact Jotform Support:

Send Comment:

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


  • Technology Committee
  • Isabella Chung
  • Julie Busuttil
  • Felipe
  • Cortesias Edam
  • Mary Jordan
  • Eric Stephenson
  • Margie Lagerwall
  • NJW
  • dejan rankovic
  • neraviola
  • Facultad de Arquitectura y Diseño
  • Franklin Cotes
  • tzur farm
  • Zbulo! Discover Albania
  • Michael Knight
  • Mario Acosta
  • Martin Eberle