​
About data references

Data reference is a dynamic placeholder in your workflow. When a step in the workflow is activated, the data reference will come from the information given in a previous step and be provided as a value.

For example, if someone enters their name in step one, step two might use a data reference in an email where the name that was provided in step one is used.

​
Watch a video tutorial

​
Add a reference to the form field

You can add references to form fields that are radio buttons, instructions, or drop-downs.

To do that:

  1. On the form screen, click the settings icon.
Image of the email step with the settingas icon highlighted
  1. Click the braces icon.
Image of the email form field with the braces to select data references highlighted
  1. Select the reference you want to add from the dropdown. The dropdown is organized so that you can see which data can be extracted from which step.
  2. Click Save changes.

When you use data references to transfer images or files(for example, from one form to another), make sure you’re using the same form fields. For example, if you uploaded an image with an image upload form field, and you want to populate a form with a data reference of this image, make sure the field you’re populating is an image upload form field. Trying to populate a file upload form field with an image data reference might cause errors on step completion. Likewise, using a file form field data reference to fill in an image form field won’t work.

​
Use data references in complex scenarios

You might use data references when you integrate with external tools and want to send data to the tool and extract the information back later, or send data from one workflow to another.

You can also define your own data references based on response values (for example, a sum of a calculation) available in an external tool.

​
Referencing long text inputs

When referencing long text inputs in integration steps, use the JSON-formatted reference rather than the plain-formatted reference. This ensures that special characters such as linebreaks and quotes are encoded correctly.

​
Find IDs to reference form fields or steps