How to Use the Spreadsheet to Form Widget

May 14, 2025

Populating your form fields from an external Excel sheet is now easier than ever. With our Spreadsheet to Form Widget, you can upload a spreadsheet and use its data to automatically fill out form fields based on a unique code. This is ideal for pulling existing records and displaying them on your form, similar to querying a database using a unique key.

Widget Requirements and Limitations

Before you continue, here are some important limitations and key points to keep in mind when using the Spreadsheet to Form widget:

  • The widget only accepts XLS or XLSX files. Other formats such as CSV or Google Sheets aren’t supported.
  • You can place the unique code you use for searching anywhere in your sheet—just make sure to set the correct column index during configuration.
  • The unique code is case-sensitive. So the code entered in the form has to match the exact format in your spreadsheet.
  • The column names in your sheet need to match the field labels on your form for the data to populate correctly.

For instance, if your form fields are labeled as follows:

Form Sample in Jotform to match with the Spreadsheet Column Names

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

Spreadsheet File with Sampel Column Names to be use in the Spreadsheet to Form Widget in Jotform

Here’s the demo form and sample spreadsheet used in the setup above. Use them to explore how the widget works and test pre-populating fields using unique codes.

The arrangement of fields on your form doesn’t matter, even if there are unrelated fields in between. What’s important is that the form field labels exactly match the column names in your spreadsheet.

The widget currently supports the following form elements:

  • Full Name
  • Email
  • Time
  • Short Text
  • Long Text
  • Dropdown
  • Single Choice
  • Multiple Choice
  • Scale Rating
  • Star Rating

When a valid unique code is entered, the form will automatically clear the existing values in supported fields and replace them with the corresponding values from your spreadsheet.

Setting Up the Spreadsheet to Form Widget

Now that your form and spreadsheet are ready, it’s time to set up the Spreadsheet to Form widget. Here’s how:

  1. In Form Builder, click on Add Element on the left side of the page.
Click Add Element in Form Builder in Jotform
  1. Now, in the Form Elements menu, under the Widgets tab, search Spreadsheet to Form and click on it to add it to your form.
Search and select Spreadsheet to Form widget in Form Builder in Jotform
  1. Next, in the Widget Settings window that opens on the right side of the page, click on Upload File and upload your spreadsheet file.
How to Use the Spreadsheet to Form Widget Image-1
  1. After that, in the Access code column, choose the label from your spreadsheet file that you’d like to use as the Access Code. 
Select the Access Code column from your uploaded spreadsheet in Jotform
  1. Then, set up the rest of your widget settings:
    • Fill Button Text — Customize the button text to begin filling the fields with data from your spreadsheet.
    • Loading Text — Choose the text that will appear while the widget processes the access code and fetches the spreadsheet row data.
    • Valid Code Text — Set the message that’ll be displayed when fields are successfully autofilled.
    • Invalid Code Text — Enter the text to show when the widget can’t find the access code provided.
Customize fill button, loading text, valid and invalid code text in Spreadsheet to Form widget in Jotform
  • Submit Input Field Value — Choose whether to include the input field value in the submission.
  • Autofill By Condition — Automatically fill in fields based on a condition.
  • Reset Fields When Invalid — Reset the fields if the access code provided is invalid.
  • Run in the Background — Hide the widget and run it in the background (this option requires the Autofill by Condition feature to be enabled).
Spreadsheet to Form widget settings including submit input, autofill by condition, and background mode in Jotform
  1. Now, just click on Update and you’re all set.
Click the Update button to save widget settings in Jotform

That’s it! With your widget fully configured, your form is now ready to dynamically pull data from your spreadsheet, making form filling faster, smarter, and more personalized for your users.

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:

  • Horse Events - Profile picture
  • MD - Profile picture
  • Wendy Larson - Profile picture
  • ODAI - Profile picture
  • Rusty - Profile picture
  • Oz Longa - Profile picture
  • Philip Lindskog - Profile picture
  • Suzanne Gowdy - Profile picture
  • Craig Watkins - Profile picture
  • Tracey Watson - Profile picture
  • Alexandria Scholze - Profile picture
  • Mirror Cool - Profile picture
  • Benjamin Londa - Profile picture
  • Ryan - Profile picture
  • oir - Profile picture
  • TeamFlow - Profile picture
  • TeamFlow - Profile picture
  • Roger Sutter - Profile picture
  • Melissa - Profile picture
  • Pat Pettit - Profile picture
  • GR Designs - Profile picture
  • servclient - Profile picture
  • John Bryers - Profile picture
  • dm-test-account - Profile picture
  • Tanya de Maurivez - Profile picture