Create an HCMS Categories List

Prev Next

This article walks through how to create a list based on the categories configured in your HCMS integration. 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.

Instructions

  1. You will first need an active HCMS Integration

  2. Sign in to your site

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

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

  5. Select the HCMS Categories tab and add a Label The HCMS Categories list tab with the Label field highlighted.

  6. Select the environment you wish to add the list to HCMS categories section with highlighted environment options.

  7. Click Add All Categories to add all categories from your HCMS instance or select individual categories using the Available Categories dropdown The available categories drop-down list and a button to add all categories.

  8. Click a Category name to update its label, if desired Highlighted category selection on a list.

  9. In the Color column, click the color picker to select a color for an option The categories list with the Color column highlighted.

  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 Selection of categories with the reorder icon highlighted.

  11. Click the Delete icon (black trash-can icon) to the right of a category to remove it from the list List of available categories with a highlighted delete icon for removal.

  12. If needed, toggle on Show Always Display Options and check the options that should always display in the list The 'Show Always Display Options' toggle enabled on the list.

    Note:

    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. Click Save The Save button on the new list screen.

  14. You can now add the list to a user-select element (checkbox, radio button, select, or autocomplete) on a form HCMS Categories selected on the List tab of a form element.

  15. If you have an HCMS workflow event configured then this will automatically pull in any selected categories and add them to the category of the content being created Submission Events section highlights categories added from HCMS form elements.