What is the Pre-populate Link?
The Pre-populate Link pre-populates items on your form with values you've passed into the link's URL. Using this requires a little technical knowledge of how URLs work.
How to use the Pre-populate Link
On your form's "Share" page, copy the "Pre-populated Form" link URL. Then, edit the example parameters in the URL and change them to the values you want to pre-populate.
The general format for the Pre-populate Link is:
- item: The position of the item on your form. The first item on your form is
1, the second item is
2, etc. Alternately, you can use the item's ID, which you can find on the item's settings page or on the form's "Settings -> Integrations -> API" page, using the format
- YourValue: The URL encoded value to pre-populate into the item.
For text field item types, the value should be the text you want to populate. For multiple choice item types, the value should be the position of the choice you want to select. All values should be URL encoded to prevent issues with special characters and each parameter in the link should be separated with
&, as shown below.
All item types except File Uploads, Multi-scales, and Signatures can be pre-populated.
Pre-populate Form Link Example
Below is an example of a Pre-populate Link for a form with Short Answer, Radio Button, Checkbox, Dropdown, Radio Button Matrix, and Checkbox Matrix items.
This form can be pre-populated as shown using a link with parameters like:
In the above URL:
2=First+Lastnamepopulates the Short Answer item in position 2 with "First Lastname".
3=1populates the Radio Button item in position 3 with its choice 1, "Parent".
4=1populates the Checkbox item in position 4 with its choice 1, "Driving".
4=4populates the Checkbox item in position 4 with its choice 4, "Tear-down".
5=1populates the Dropdown item in position 5 with its choice 1, "Camping".
Matrix item types are similar but also include a reference for a sub-question:
6-1=1populates the item in position 6, sub-question 1 with its choice 1, "not".
6-2=3populates the item in position 6, sub-question 2 with its choice 3, "very".
6-3=2populates the item in position 6, sub-question 3 with its choice 2, "somewhat".
7-1=3populates the item in position 7, sub-question 1 with its choice 3, "Evening movie".
7-2=1populates the item in position 7, sub-question 2 with its choice 1, "Swimming".
7-2=2populates the item in position 7, sub-question 2 with its choice 2, "Canoeing".
7-2=3populates the item in position 7, sub-question 2 with its choice 3, "Evening movie".
7-3=1populates the item in position 7, sub-question 3 with its choice 1, "Swimming".
Alternately, the item's ID can be used in place of its position:
id21=First+Lastnamecorresponds to the item with an ID of "21", and it will be populated with the text "First Lastname". In this example, this could take the place of
2=First+Lastnameabove, assuming that item's ID is "21". It can be helpful to use IDs since, unlike positions, they do not change if you add or move items.
If you have a multiple page form, only items on the first page of your form can be pre-populated. Pre-populate cannot be combined with Save & Return or password protected forms since they add a page before the first page of your form.
You can also pre-populate an Embedded Form.