What do LIST blocks do?
LIST blocks prompt the end user to provide a list of entries. This list can then be referenced through the LIST variables. Learn more on referencing variables.
LIST blocks are also used along with the LOOP block where for each entry in a paired list, the pages in the Loop are run through once. Learn more about LOOP blocks.
What are LIST variables used for?
LIST variables can be referenced to:
- Display a list of all entries the user has entered
- Create dynamic table rows inside a TABLE block. Learn more.
- Create dynamic table rows with a LOOP function inside a rich style document template. Learn more.
How to add and configure a LIST block
- Drag in a LIST block from the left panel and connect it to the other blocks
- Add Header under the “Header” field and a question or prompt inside the textbox (i.e. rich text editor) on the right panel in the Property Editor to help the end user insert the correct values in the list
Note: It is best practice to bold the questions/prompt similar to when formatting questions in Paragraph fields of FORM blocks.
For example, in a budgeting tool, you may want to prompt the end user to enter their expense items. Therefore the added Header is “List of Expense Items” and the added prompt is “Please list your items of expenditure”. See below screenshot.
3. [Optional] You can use the "Disable BACK button" toggle to prevent users from accessing any pages before this block. Turning this toggle ON will hide the "BACK" button on this page, as well as prevent the end-user from navigating back via the transcript. Any route backs returning to pages before this block will continue to work.
Disabling the back button is useful in the following cases:
- You have an integration before this block, and you want to prevent users from accidentally triggering it twice
- You have email(s) before this block, and you want to prevent users from accidentally triggering it twice
- You're presenting some outcome to the end-user, and want to prevent them from returning to previous pages and changing their answers
- You've reached the end of the app, and would like to prevent the user from modifying their submissionAn example of the "Disable BACK button" toggle on a FORM block. This feature is also available on the List, Yes/No, Table, Transcript, Doc Review and End blocks.
How to show LIST size
You can write conditions to create logic based on the number of values (entries) in a list using the operator LIST_SIZE. The below examples illustrate some of the different ways you could reference LIST_SIZE when writing conditions to create logic in Checkbox.
|If there are no values in LIST123.
|LIST123_SIZE < 1
|If there is only one entry in LIST123.
|LIST123_SIZE == 1
|If there is more than one entry in LIST123.
|LIST123_SIZE > 1
Essentially, the LIST_SIZE variable is a number output and can be referenced and used with Operators as you would for a numerical value.
Please note LIST variables have a limit 1000 items.