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. If the dropdown list is set to required and a empty value is selected, it will not be accepted.
  5. Define a list option:
    1. Set a Label
    2. Set a Value.
  6. For additional list items, click the "+" sign 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 select 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.