Dropdown List

Summary

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

Instructions

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
   
   
   
   
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.
   
   
   
   
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 macro. A graphical placeholder of the macro will be added to the page.
   
   
   
   
10. Preview or Save the page to see the final dropdown
    
    
    
    
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
    
    

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.