Skip to main content

What are URL parameters?

URL parameters are information added to the end of a link. They start with a question mark ? and use key-value pairs in the format key=value. Multiple parameters are separated by an ampersand &. For example: https://forms.fillout.com/t/9ofaEF4d54us?name=Jane+Doe Here, name=Jane Doe is the URL parameter.

Video tutorial

How URL parameters work

With URL parameters, you can pass information to a Fillout form, such as a respondent’s name, email, or where they came from. This information is stored in hidden fields. You can use it to:
  • Pre-fill fields with information you already know, like a respondent’s email
  • Display information in the form, such as a respondent’s name
  • Track where your form was shared via a utm_source parameter (e.g., Facebook, Google, Instagram, etc.)
  • Write data to any integration with mappings

How to add a URL parameter or hidden field

1

Open form settings

Click the gear icon  on the top right.
Form editor top bar with the settings icon highlighted
2

Register a new parameter

Click URL parameters followed by + Add new, then enter the parameter. In this example, we’ll choose “name”.
URL parameters settings with the Add new button and name and email suggestions
You can optionally provide a sample value for the parameter, if you’d like to see what your form looks like with that value being used (e.g. if you have some hide/show logic based on it).
3

Reference the parameter in your form

There are many ways you can use URL parameters as listed above. In this example, we’ll show a respondent’s name at the beginning of the form.Type @ and click the link icon , then choose your parameter.
Heading with the name URL parameter inserted from the @ menu
To prefill a hidden field, set the parameter as the Default value, and Hide always.
Email field with the email URL parameter as its default value and Hide always turned on
4

Share your form link

To activate a URL parameter, add its value to the form link. For example, if you have a name parameter, add the respondent’s name at the end of the link: https://forms.fillout.com/t/9ofaEF4d54us?name=jane
Form greeting the respondent with Hello Jane! from the name URL parameter
Format URL parameter values
  • + - use a plus icon to space out values (e.g. Jane+Doe)
  • & - use an ampersand to separate different types of parameters (e.g. email=jane@gmail.com&name=Jane+Doe)
Configure URL parameters with AI You can also ask Form Agent to help you add and manage URL parameters or hidden fields for your form. Learn more here.

Send URL parameters to integrations

Fillout stores URL parameters by default on the Results page. Aside from the name and email, this can be language used, links shared on Facebook, Instagram, or LinkedIn to compare traffic, and many more.
Results table with the name URL parameter shown as a column
You can also write these URL parameters to your database or other types of integrations by mapping them. They are typically found when you click the link icon in the picker.
Airtable mappings with the lang URL parameter mapped to a Language field
In some cases, the URL parameter may not show up in the picker. A workaround is to create a hidden field and map that instead. See step 4 below.

Track the form language used in responses

1

Register your URL parameter

If you haven’t already, create one first following the steps above. In this example, we’ll record the language used. Label the parameter as lang.
Translations are available on the Fillout Business plan, and on Team and Enterprise. Zite Free, Pro and Business plans don’t include them for forms. See Fillout pricing.
2

Enable translations

In your form settings, add the languages you’d like the form to be available in.
Enable translations turned on with French and German added
By default, respondents will see a language picker. This can be hidden using CSS if needed. More info here.
3

Map it to your integration

If you haven’t connected an integration yet, click Integrate on top to connect.Under Mappings, link your URL parameter, which can be found by clicking the link icon .
Airtable mappings with the lang URL parameter mapped to a Language field
4

Create a hidden field (if needed)

In cases where the URL parameter can’t be directly mapped, follow step 3 of this section to prefill a hidden field with the lang parameter, then map this field to your integration.
Integration mapping with the Language form value mapped to a Language field
5

Publish and share your form link

By default, respondents can choose their language from a language picker. Their selection is recorded as its language code (e.g., fr for French). (See the list of language codes below.)
Form shown in French with the language switcher open
To preset a language, add its code to the URL. For example, https://forms.fillout.com/t/9ofaEF4d54us?lang=fr. The form will automatically display in French.
If a respondent doesn’t manually choose a language from the dropdown or if you don’t preset a language in the URL, the language used will not be recorded.

Send data between forms

You can pass data from a main form to a subform using URL parameters so respondents won’t need to re-enter the same information. Check out this guide.

Other advanced features

Form parameters

Share data between forms with URL parameters.

Pre-fill fields

Pre-populate fields based on previous inputs and more.

Answer piping

Insert previous answers into upcoming questions or fields.