Variable text allows you to insert, or "pipe", custom text from your test into a question in a questionnaire, allowing for a more customized, dynamic, and personal survey experience. The piped variable text appears as a line of code in the questionnaire builder but when you preview or take the survey, this code will be replaced with the variable text.
All available variable texts are listed in the questionnaire builder's Variables library, including system default variables and custom fields with a variable name entered.
| SEE ALSO – Answer Piping Variables for details on how to insert piped answer text from a previous question into a question on a later page in the questionnaire. |
Following are the available system default variable text strings:
| {{sample_name}} | Displays the Report Name specified in Sample Details.
|
{{sample_code}}
| Displays the 3-digit or 4-digit Blinding Code used to verify sample entry. |
| {{sample_description}} | Displays the Description specified in Sample Details. |
| {{sample_image}} | Displays the sample's image uploaded in Sample Details.
|
| {{participant_name}} | Displays the Name specified in the Participants table. |
| {{participant_email}} | Displays the Email specified in the Participants table. |
| {{participant_note}} | Displays the Notes specified in the Participants table. |
| {{participant_code}} | Displays the Participant Code used to login to a test. |
{{participant_verification}}
| Displays the Verification Code used to login to a test. |
{{participant_external_id}}
| Displays the External ID specified in the Participants table. |
{{participant_locale}}
| Displays the language code for the Language selected to take the survey.
|
| {{day}} | Displays the Day number the sample has been served on. |
{{position}}
| Displays the Position number the sample has been served in.
|
{{project_name}}
| Displays the Project Name specified when you Create a Project. |
{{project_description}}
| Displays the Project Description specified when you Create a Project.
|
| SEE ALSO – Custom Fields for further details on adding custom fields. |
NOTES:- The variable text string is case sensitive and must be entered exactly as specified above.
- Variable text stings can be enclosed in either a '# #' or '{{ }}' bracket format. For example, #sample_code# and {{sample_code}} are both supported formats.
- A Variable name must be entered on the Custom Fields form before it is available from the Variables library.
- If there is no text entered in the variable's source field (i.e. in Sample Details or Participants table) no text will display where the variable text string is specified in the questionnaire.
- Variable text will not display in the Questionnaire Builder Preview. Variable text will only display in the Test Previewer and when participants take the surveys.
|
To insert variable text:
- Select the Variables library to expand the list of available variable text strings.
| NOTE – Variable names are preceded by the form the field is sourced from, where 'sample_' indicates a field in Sample Details, 'project_' indicates a field in the Project Form, and 'participant_' indicates a field in the Participants Table. |
- Click on a Variable to copy the variable text string to clipboard.
- Paste the variable text string where you'd like the text to display in the question.
The variable text string display blue, italicized and underlined in the Questionnaire Builder's Preview, indicating a valid variable text string is being used.
| NOTE – Variable text will not display in the Questionnaire Builder Preview. Variable text will only display in the Test Previewer and when participants take the surveys. |
- When you preview the test or when participants take the survey, the variable text is displayed within the question.
