Skip to main content
Variables are the computed half of Embedded Data — the values the survey works out for itself while the respondent answers. Nothing renames; see Hidden Fields & Variables for what is new around them.

Types of Variables

There are three types of variables you can add to your survey:
  1. Text: You can add text variables to your survey to capture text data.
  2. Number: You can add number variables to your survey to capture number data.
  3. Date: You can add date variables, set with an expression such as now(), to record when something happened or to count days with daysBetween(). Dates are stored in UTC. A date variable is listed only in the API’s typed embeddedFields, not in the older variables list.

How to Add Variables

  1. Open the survey in the editor, stay on the Questions tab and scroll to the bottom. You will find the Embedded Data card.
  2. Choose Add field, then Create new field. Set the source to Calculated, give it a name, choose its type — text, number or date — and set a default value. Add as many as you need.
A calculated field added here has one name, and it is both what recall and logic refer to it by and what the response table shows — so it has to read like a key: lowercase letters, numbers and underscores. Its storage address is generated for you and never typed. The Embedded Data card, with the calculated field score beside two passed-in fields The score row above is a calculated field: Calculated as its source, 0 as the value it starts at, and a generated address you never type.

Use cases

  • Quiz: You can use variables to create a quiz. For example, you can add a variable score and update it every time a user answers a question. You can also use the variable for recall to show the final score to the user.
  • Personalisation: You can use variables to store user data and personalise the survey experience. For example, you can add a variable full_name and update it every time a user fills in their first name and last name. You can use the variable to personalise the survey experience by addressing the user with their full name.

How is it different from Hidden Fields?

Variables are different from hidden fields in the following ways:
  1. Setting: a passed-in field is filled from a URL parameter or the SDK; a calculated field can only be set at creation or updated by logic actions as the survey runs.
  2. Updating: Hidden fields cannot be set again, but the value of variables can be updated while the user fills the survey.
  3. Type: a passed-in field can be text, number, true/false or a date; a calculated field is text, number or a date, the types survey logic can produce. A calculated date is set with an expression, such as now().

How to use Variables

  1. Once you have added variables to your survey, open the Flow tab and a rule. The list of what a condition can test has an Embedded Data group with your variables, between the hidden fields and the survey info.
The If list of a rule, scrolled to the Embedded Data group with the variables fee_score, tenure_days and segment
  1. Use a variable in a condition, and update it with a Set value action as the respondent answers. This rule sends quiz takers whose score is 2 or more to the pass ending:
A rule that tests a variable: If score is 2 or more, then Jump to the ending Well done, you know your money basics

Recalling Variables in the Survey

You can recall show the variable value to the respondent by using the Recall Data function.
To know more about how to use logic in Formbricks, check out the Conditional Logic.