Reference tags are used to link question answers data, and constant values, to other data dynamically. All reference tags are contained within square brackets '[ ]' and operators and other path data, like pointing at specific answers when there are multiple, uses a point '.'.

Question Reference Tags

Question are usually formatted [q 'question number' . 'answer number/name'], so a question with multiple answer questions will just change the answer number or name for each answer. However some questions can have unique outputs and multiple of them, in these cases the answer number becomes a string like filename or base64.

If you are unsure what the correct reference tag is meant to be, the question reference is noted in the top right of the inspector panel, clicking on this reference will copy its reference tag to your clipboard.

Alternatively, simply click and drag the answer to a text box and it will be automatically filled with that questions reference tag.

Questions should only refer to other questions which come earlier in the form structure.

🚧

References to later questions (a forward reference) may work, but can also behave unreliably; for this reason forward references are not recommended.

🚧

Question reference tags operate differently within a repeater context.

Within a repeater, question tags are only able to retrieve answer data from within their current repeat. To reference a previous repeats' question answer the previous tag is required.

reference dependencies

Finding reference dependencies is in the question more options menu, in the inspector panel, next to the question reference. You can also get to it using the context menu, in the Pages panel, when you right-click an item that can be referenced.

operators

Additional operators can provide extra control to the data being passed through reference tags.

• [Protect.q1.1] - Used to protect a value after it has been referenced so it can't be edited by the user.
• [q1|default] - A question reference default value can be set using the pipe character | and entering the default value after it.

Constant Reference Tags

When sending emails to users (usually the assignee of a Workflow task), SmartIQ can replace a number of pre-defined values with corresponding information which it might otherwise be difficult or tedious for the designer to obtain.

[ProjectLink] reference tag

The [ProjectLink] reference tag is replaced by a HTML link that points to the current workflow state for a project.

Reference tags in a project link can be combined using '|'.

Parts of the resulting Project Link can be overridden with:
LinkUrl=
LinkText=
StateName=
ProjectName=
ProduceUrl=

These are passed as a pipe-separated list of key-values:
[ProjectLink|LinkUrl=https://google.com|LinkText=This is a link to google]
The above example will result in a link like:
<a href="https://google.com">This is a link to google</a>

If a ProduceUrl is supplied, other values will be appended to it to construct the URL as if the supplied value were the Produce URL of the system.

The positions of the placeholders in the formatted link are as follows.

If LinkText is not supplied:
<a href="LinkUrl">ProjectName - StateName</a>

If LinkText is supplied and is not empty:
<a href="LinkUrl">LinkText</a>

If LinkText is supplied as empty:
LinkUrl

📘

Temporary Users

If FlagAsTempUser is supplied as a pipe-separated argument and the user is attempting to access a form that they have already completed, they will see a This form is no longer available message rather than the user login screen.

Connector specific Reference Tags

Repeater specific reference tags

🚧

The 'previous.' reference tag will make a repeated question return 0 if the question is self referencing.

Nested actions

Action inputs in workflow can reference previous action output using [parentaction.output]

Reference Tag Exemptions

Certain properties of certain blocks can't read reference tag data or don't have any reference tag data. These are Exemptions, where reference tags don't work or are inapplicable.

Writable Data Objects