Query parameters as a data source

Learn how to use query parameters to personalize Docs

Maruša Barle avatar
Written by Maruša Barle
Updated over a week ago

Note: This feature is available if you have purchased the Personalization module. Please get in touch with your account manager if you are interested.

Query parameters are the simplest data source to use in personalization. As long as you have personalization enabled on your account, there's no setup required. Learn more about other possible data sources here.

Let’s personalize a Turtl Doc with some query parameters. Most commonly, a data source expression should be placed in the prefill value field of the personalization form.

In the example below, our Doc has two personalization fields, one for name, and one for company.

1. Open the personalization form builder for your Turtl Doc.

2. Select the name field and type $:datasources.queryParam('name') into the 'prefill value' field.

As a bonus, we also have a shorthand expression available for query parameters, which is datasources.qp('name').

4. Select the company field.

5. Type $:datasources.queryParam('company') or $:datasources.qp('company') into the 'prefill value' field.

6. Click 'Publish'

Your Turtl Doc is now ready to be personalized with query parameters by adding them at the end of Turtl Doc URL.


The personalization engine is protected by US patents.

Did this answer your question?