Dropdown List


Dropdown lists should be used when you want users to pick from a list of options.


  1. Create your Form using the Forms for Confluence macro.
  2. Add the Forms - Dropdown List macro to the form.
  3. Set a Name for the list.
  4. Set a Label for the list; this will appear next to the checkbox options.

    1. (Optional) Set a Description for the list.
    2. (Optional) Set a Null Value and Label Option. This will appear at the top of the list as a placeholder with no value. It will not be accepted if the dropdown list is set to required and an empty value is selected.
  5. Define a list option:
    1. Set a Label
    2. Set a Value.
  6. Click the "+" sign for additional list items and repeat step 7.
  7. Save the macro. A graphical placeholder of the macro will be added to the page.

  8. Preview or Save the page to see the final dropdown menu.

  9. Alternatively, you can make the dropdown a multi-select dropdown by checking the Multiselect option.
  10. Preview or Save the page to see the final multi-select dropdown menu.

    1. Once you have selected one option, you can choose another.

Using Empty Values with the Dropdown List

You can set options in the dropdown list that have an empty value. This can be useful when you want to force users to pick from a list and provide an empty value at the top, or it can be used to break up a list by having empty values in between sections of a list.

When using empty values, it is recommended that you set the required parameter to true, ensuring that users have to pick an item from the list.

On this page