What are URL parameters?

Ready to get started using URL parameters? Check out our guide here!

Do you already know your respondent’s name, email, or other information? With URL parameters, you can feed this right into your form so respondents have a more personalized experience, and you can focus on getting the data you really want.

This article explains the basic concept of URL parameters, a Free account feature.

How do URL parameters work?

Short answer: with information added to the end of your form URL. So you'll see something like first_name=jon or email=example@example.com at the end of your form URL.

For example, if this is your form’s URL, https://yourname.typeform.com/to/abc123, you can add a different first_name for each of your respondents by directing each person to a slightly different URL, like this:

https://yourname.typeform.com/to/abc123#first_name=Cuthbert

https://yourname.typeform.com/to/abc123#first_name=Dorothy

https://yourname.typeform.com/to/abc123#first_name=Boris

You can add this information manually, or automatically using a tool like MailChimp.

This value, first_name, can be used like a variable throughout your form, however you please! For example, you could configure your form’s Welcome Screen (the very first thing each respondent sees) to show a unique message, customized just for them:

The blank space will be replaced by the name you add to your URL parameter.

You can continue adding URL parameters for anything else you already know about your respondents, and use each piece of information throughout your form in the same way.

Here are some examples of URL parameters that add name and purchase to a product feedback form.

https://yourname.typeform.com/to/abc123#first_name=Cuthbert&item_purchased=Wigwam%20Chimney

https://yourname.typeform.com/to/abc123#first_name=Dorothy&item_purchased=Penny-farthing

https://yourname.typeform.com/to/abc123#first_name=Boris&item_purchased=Inflatable%20Potato

These URL parameters can pipe information into the questions in your form, like so:

Any values that you feed into your form as URL parameters will be stored in your results too! So you can use URL parameters for other purposes like tracking sources or segmenting your audience.

To get started with URL parameters, open your form from your workspace. Click Logic, then Pull data in.

You can now see the URL parameters dialog, and can start typing the names of your URL parameters:

Check out this article for more information on how to set up URL parameters.