Skip to main content

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. 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.

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.

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.

Referencing images

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.

Find IDs to reference form fields or steps

  1. In your left-hand navigation, click the Workflows icon.
  2. Hover over the follow-up workflow and click on the menu icon.
  3. Click Edit workflow.
  4. Click the step to which you’d like to send data.
  5. Copy the step ID. It’s the last number in the URL you see in your browser.
Image of the Next Matter URL with the step ID highlighted
You can get the ID by clicking the workflow and copying the number from the URL in your browser.
Image of the Next Matter URL with the wotkflow ID highlighted
  1. In your left-hand navigation, click the Workflows icon.
  2. Hover over the follow-up workflow and click on the menu icon.
  3. Click Edit workflow.
  4. Click the step to which you’d like to send data.
  5. Click the ID icon for the field to which you want to copy data.
  6. Copy Form field ID.
Image of the short text form field with the form field ID highlighted

FAQs

This reference applies to user variables (variables generated from the API response data) and helps unwrap the data from webhooks and integration steps. Read more about the first result reference
This resolves to the email of the user who completed the step. As the assignee can change based on specific configuration (as is the case for conditional assignee, automatic delegation, or out of office settings), this field reflects the actual completer rather than the original assignee.
I