@ References

The @ symbol is how you pull values from fields and variables into your form logic. It works the same everywhere — in variables, conditions, question text, calculations, and redirect URLs.

How it works

  1. Place your cursor where you want to insert a reference
  2. Type @
  3. An autocomplete menu appears showing all available fields and variables
  4. Start typing to filter, then press Enter or click to insert

The reference appears as a chip in the editor. When respondents fill out the form, the chip is replaced with the actual value.

Where you can use @ references

  • Variables — @quantity * @price reads field values to compute a result
  • Condition rules — @age >= 18 tests a field value
  • Question text — Hi @name, what's next? pipes an answer into the text (respondents see the actual value)
  • Inline calculations — Total: ⌈@price * @qty⌉ shows a computed number
  • Redirect URLs — https://example.com?score=@score passes data as a query parameter

What appears in the autocomplete

The autocomplete shows fields, variables, and hidden fields that are defined above the current position in the form. This ensures every reference points to something that already has a value.

Inside a repeat block, the built-in @repeat_number variable also appears — it holds the current iteration number (starting at 1).

Tips

  • Position matters — you can only reference things above the current block, and the autocomplete enforces this automatically
  • Hidden fields work exactly like regular fields in @ references
  • If you rename a field, all @ references to it update automatically
  • Fields inside a repeat block can’t be referenced from outside the repeat (they have multiple values)

Related articles