Create a Custom List

Prev Next

A Custom List allows you to configure your own lists, similar to creating an option set in a form. You can either manually add your own options or you can upload a CSV.

The benefit of adding a list is that it can be added to any form. If the list needs to be changed, that change only needs to be made once, and the forms will automatically update to use the new list.

View the Create a Dynamic List article for information on how to call external services using an API.

Instructions

  1. Sign in to your site

  2. Navigate to Advanced Tools, then select Lists The Advanced Tools menu expanded with Lists selected in the sub-menu.

  3. Click Add List (plus-sign icon) in the bottom-right corner of the screen The 'Add List' button.

  4. On the Custom tab, add a Label The Custom list tab with the Label field highlighted.

    Note:

    This is the name the user building the form will see when they add it to a form so we recommend keeping this short but descriptive.

  5. Select the environment you wish to add the list to Options for environments on a list.

  6. Click Upload CSV to import a file or click Add Option as many times as needed to manually add options to the list Options to upload CSV and add new options for a list.

    Note:

    View an example CSV file.

  7. Add or edit the label for an option in the Label field A highlighted label name for a list.

  8. The Value field will automatically populate, but you can click the value of an option to update it if desired A highlighted value name for a list.

  9. In the style column, click the color picker to select a color for an option or click the camera icon to upload an image that will be displayed for the option Table displaying styles options for a list.

  10. Click and hold the order handle (horizontal-lines icon) to the left of an option to drag and drop it into the desired order The reorder list icon highlighted next to an option.

  11. Click Delete Option (black trash-can icon) to the right of an option to remove it from the list Table displaying a list of states with a highlighted delete icon.

  12. If needed, toggle on Show Always Display Options and check the options that should always display in the list Settings menu showing options for states with 'Always Display' feature highlighted.

    Note:

    Enabling this option will add an "Always Display" column to the list. Checking "Always Display" for an associated option will ensure that the option is always visible to the user and cannot be filtered out by user input.

  13. If applicable, select Copy to Environment to copy the list to another environment Button to Copy to environment on a list option.

  14. Click Save The Save button on the new list screen.

  15. You can now add the list to a form Form element with a custom list selected in the drop-down.


Resources