Skip to main content

Dropdown sets

A dropdown set is a named list of options that dropdowns use. Changes to a set apply to every dropdown that uses it, so a typo is fixed in one place.

Global sets and space sets​

Global setsSpace sets
Available inEvery spaceOne space
Managed inConfluence settings → Dropdown setsSpace settings → Dropdown sets
Managed byConfluence adminsAdmins of that space

In the macro editor, authors see both: the global sets and the sets of the page's space.

Managing sets​

Both settings pages list the sets with their options. Admins create, edit and delete sets there. Try it: create a set, edit one of the sample sets or delete one.

Loading live demo…

Everyone else sees the same list read-only:

Loading live demo…

The global sets page in the Confluence settings works the same way:

Loading live demo…

Set fields​

FieldWhat it does
NameShown to authors when they choose a set, and in a dropdown while nothing is selected. Names are unique within global sets and within each space (ignoring case).
OptionsOne option per line, in the order the dropdown shows them. Each option must be unique; blank lines are ignored.
Colored optionsShows the options as coloured labels. Choose a colour per option from the picker or type a hex value; the text colour adjusts for readability.

Every set can be used by single- and multi-select dropdowns. Whether people can pick several options, and which option is selected at first, is chosen per dropdown in the macro editor. While nothing is selected, a dropdown shows the set's name.

What happens to existing dropdowns​

  • Editing options updates every dropdown that uses the set. A dropdown whose selected option was removed shows the set's name instead, until someone picks an option again.
  • Deleting a set leaves the dropdowns that used it without options. They show a message asking to choose another set in the macro editor.