Custom Query Parameters

Add metadata to your Questionnaire Shareable links

George Karmelich avatar
Written by George Karmelich
Updated over a week ago

The great thing about Questionnaire Shareable links is that anybody with this link can submit your questionnaire. However, what if you want more information from the questionnaire submitter than just their email address?

Below, we will walk through a simple use case. Let's assume we have an example user who currently posts their Shareable link in two places: on their website and in their email signature. Our user would like to know how each questionnaire submitter is accessing their questionnaire (from the email signature or the website).

Obtaining this data via custom query parameters is easy. First copy the Shareable link from an existing questionnaire. In this example, let's use the following example URL:

https://app.woodpecker.legal/form/123456abcdefg

We can then add any custom query parameters we like to the end of the URL. For the first link (the one placed on the website), we'll create a query parameter with a key called source and a value of website (source=website). For the second link (the one placed in the email signature), we'll create a query parameter with a key named source once again but the value will be email this time (source=email).

After appending the query parameters to the URL (the regular URL and query parameters joined by a ? character), we now have two distinct links:

  1. https://app.woodpecker.legal/form/123456abcdefg?source=website

  2. https://app.woodpecker.legal/form/123456abcdefg?source=email

Next, we'll replace the links that are currently on the website and email signature with the respective links including the query parameters.

When somebody clicks on one of these links and submits the questionnaire, the query parameters will be passed through and processed by Woodpecker. In the final email you receive along with your populated documents, an additional CSV file containing your query parameter(s) will be attached. This CSV file can then be used to track and measure where the people who submitted your questionnaire found the link.

Multiple query parameters

Please note that you can append as many query parameters as you like to a Shareable link. Simply separate each query parameter with a & character and each query parameter will be returned within a CSV file in the final email you receive with your documents. More info on query parameter construction here.

Using Query Parameters with Zapier

In addition to the above use cases, these query parameters can also be found and processed through Zapier! Let’s use the Questionnaire Submission trigger as an example. Say we have a questionnaire in our email signature, and we’ve created a link with the ?source=email parameter (similar to the link we created above.) When someone opens the questionnaire and submits a response from that link, we’ll be able to see that source query parameter listed in the data.

We can verify this with a quick test submission, which will include our source parameter in the data as shown below:

Great! With that parameter now accessible in Zapier, you have one more data point to use in your toolkit. If you have any questions about the information in this article, please reach out to our team and we’ll be happy to help.

Did this answer your question?