Purpose
Data prefilling via URL comes in handy when you:- Have data for some of the respondents, but not all
- Have data you want the respondent to confirm or update
- Have data in a different system (e.g. your database) and want to add it to the user profile in Formbricks
- Want to embed a survey in an email and increase completion by prefilling the choice selected in the email
Quick Example
Example URL
How it works
- To prefill survey questions, add query parameters to the survey URL using the format
questionCode=answer, for exampleage=34. The parameter name can also be the Question ID (questionId=answer). - The answer must match the question’s expected type to pass validation. For Single Select and Multi Select questions,
answercan be the option ID, the option label text or the option’s answer code. - The answer needs to be URL encoded (if it contains spaces or special characters)
Skip prefilled questions
You can skip prefilled questions by adding theskipPrefilled parameter in the URL. To skip prefilled questions and show the next available question, add skipPrefilled=true to the URL. By default, skipPrefilled is set to false.
Skipping prefilled questions
Prefilling multiple values
Formbricks lets you prefill as many values as you want. Combine multiple values in the URL using&, for example: name=Bernadette&age=18. The order of query parameters doesn’t matter, so you can move questions around or add new ones without worrying about the parameter order.
Where do I find my question code?
Open a question in the Survey Editor and go to its Settings tab. The question code is in the Recode section, for exampleage or nps. Formbricks sets a code for every question (q1, q2 and so on), and you can change it before you activate the survey. After activation it is locked, so the links you have shared keep working. Learn more in Question codes and answer codes.
The parameter name is matched with the Question ID first and with the question code second. If you need the Question ID, choose Copy question ID in the question’s ⋯ menu. Links that already use a Question ID keep working.
A question code never replaces a reserved link parameter such as
lang, startAt or skipPrefilled. Those keep their own meaning.A question code names the question in the link. For a Single Select or Multi Select question, the value can be an option ID, the option label or the answer code you set in Recode. See Using answer codes.
Examples
Here are a few examples to get you started:The examples below use question codes such as
rating_question. Replace them with the code of your own question, or with its Question ID.Rating Question
Translates to 5 stars / points / emojis:Rating Question
NPS Question
Translates to an NPS rating of 10:NPS Questions
Single Select Question (Radio)
Chooses the option ‘Very disappointed’ in the single select question. The string has to be identical to the option in your question:Single-select Question
Multi Select Question (Checkbox)
Selects three options ‘Sun, Palms and Beach’ in the multi select question. The strings have to be identical to the options in your question:Multi-select Question
Open Text Question
Adds ‘I love Formbricks’ as the answer to the open text question:Open Text Question
Consent Question
Adds ‘accepted’ as the answer to the Consent question. Alternatively, you can set it to ‘dismissed’ to skip the question.Consent Question
Picture Selection Question
Adds index of the selected image(s) as the answer to the Picture Selection question. The index starts from 1Picture Selection Question
Using Option IDs for Single Select and Multi Select Questions
Single Select and Multi Select questions support prefilling with option IDs in addition to option labels. This is the most robust approach and the recommended default, especially for multilingual surveys.Why Option IDs are recommended
- Stable: Option IDs don’t change when you edit option labels.
- Language-independent: The same URL works across all survey languages.
- Reliable: No brittle string matching and fewer URL-encoding issues.
One link per option
When you create one CTA link per answer option (for example in emails), use the option ID as the parameter value:Option-ID prefill
tuk2i9ktui1lee0mfos82czbis the Question ID. A question code such asplanworks in the same place.e2r697fou23n7ba4vmt7you6is the selected option ID.
How to Find Option IDs
- Open your survey in the Survey Editor
- Click on the question you want to prefill
- Next to each option, choose Copy option ID. The ID of every option is read-only and can be copied from there
Examples with Option IDs
Single Select:Single Select with Option ID
Multi Select with Option IDs
Mixed Approach
Backward Compatibility
All existing URLs using option IDs or option labels continue to work. A value is only read as an answer code when it matches neither an option ID nor a label.Using Answer Codes For Single Select and Multi Select Questions
Every answer option has an answer code (1, 2, 98 and so on) in the Recode section of the question. Use it as the value, for example on a question with the code hello and two options coded 1 and 2:
Single Select with an answer code
Multi Select with answer codes
- The option ID
- The option label in the survey language of the respondent
- The answer code, exactly as written (codes are lowercase, so
YES_1does not matchyes_1)
If a label looks like another option’s code, the label wins. With the options “1” (code
2) and “2” (code 1), ?question=1 selects the option labelled “1”. Avoid labels that are numbers if you link by answer code.Validation
Make sure that the answer in the URL matches the expected type for the questions. The URL validation works as follows:- Rating or NPS questions: The response is parsed as a number and verified to be within the valid range.
- Consent type questions: Valid values are “accepted” (consent given) and “dismissed” (consent not given).
- Picture Selection questions: The response is parsed as comma-separated numbers (1-based indices) and verified against available choices.
- Single/Multi Select questions: Values can be option IDs, exact label text or answer codes. The system tries the option ID first, then the label, then the answer code.
- Open Text questions: Any string value is accepted.
If an answer is invalid or doesn’t match any option, the prefilling will be ignored and the question is presented as if not prefilled.