How to Pass Parameters to your Embedded Survey

One powerful feature we offer is the ability to pass additional data along with your survey responses. This can be done by appending URL parameters onto your survey link. The same data can also be passed when you are using an Embed Collector instead of a survey link.

Find out more about using parameters here: Why should I use parameters?

How do I use Parameters with my Embedded Survey?

Once you have created your Web Embed collector and embedded the provided code into your website, you will be able to manually add “data attributes” to your embed code.

Below is an example of a “Web Embed” code with some “data attributes” added (highlighted in yellow).

In the above example, we pass along two parameters: An “id” with a value of “123” and a “first name” with a value of “John“.

How do I add a Data Attributes?

You can find detailed information about HTML data attributes here: https://www.w3schools.com/tags/att_global_data.asp

What does the response look like?

Any data attributes you add to your embed code will be processed and saved along with the participant’s response. Furthermore, just like GET parameters, the data can be used within your questionnaire.

Things to look out for

A small “gotcha” that you may run into is that data attributes with multiple words, like data-first-name, will be transformed into “Camel Case” (e.g. firstName). So, if you want to use this parameter in your questionnaire, you will need to use {firstName} instead of {first-name}.