How do I use the Tags Area?

The Tags option in the editor allows you to create custom columns for forms on the All Submissions page based on information from the form submission. 

Tags can aid in searching for submissions based on user inputs or creating custom roles to view only certain submissions based on the submission tag. 

In the above image, you can see a School column displaying because some or all forms in the current list contain a Tag with that label. In this example, the value shown for School is derived from information entered into a field in each submission.

Creating a Form Tag

To define tags within the builder, add a JSON object to the Tags area with the column header* as the key and the component ID of the value you would like populated.  

{ "columnHeader": "value" }

*If the header is more than one word, use camelCasing i.e. "columnHeader" instead of "Column Header".

The example below shows how you would define the column shown in the screenshot above. The School column will populate the value entered into the component with the schoolLocation id.

{ "school": "schoolLocation" }

Using Expressions and Combining values

If you would like to use multiple component IDs to build your Tag value or an expression to evaluate data before creating the Tag, you can use Javascript or all available helper functions in the Tag value. Take a look at the examples below to give you an idea of what is possible and reach out to our team if you need any assistance.

An example of a more complex Tag that combines two components into one Tag:

{ "schoolAndYear": "`${schoolLocation} ${schoolYear}`" }

An example using a conditional ternary expression to determine the value:

{ "mealModification": "foodAllergy ? 'Yes' : 'No'" }

An example using a helper expression to determine the value:

 { "submissionID": "getSubmissionId()" }