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
    The Dropdown List macro configuration screen.
  3. Set a name for the list
  4. Set a label for the list, this will appear next to the checkbox options
  5. (Optional) Set a description for the list
  6. (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.
    Setting a null value for the first label in the Dropdown List macro configuration screen.
  7. Define a list option
    1. Set a label
    2. Set a value

  8. For additional list items, click the "+" sign and repeat step 7
  9. Save the macroA graphical placeholder of the macro will be added to the page.
    The placeholder for the Dropdown List macro example.
  10. Preview or Save the page to see the final dropdown
    The rendered example of a Dropdown List macro.
  11. Alternatively, you can make the dropdown a multi-select dropdown by checking the Multiselect option

  12. Preview or Save the page to see the final multi-select dropdown

  13. Once you have selected one option, you can select another

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.