Select
Macro adds a dropdown Select (single or multi) to Confluence pages. Options can be defined inline or loaded from an attachment. The selected value can be changed anytime — both in view and edit mode.
Key Features
- Change value anytime — the value can be changed in both view and edit mode
- Single or multi select — choose one or many values
- Options source — define options inline (newline-separated) or load them from an attachment
- Placeholder — show hint text when nothing is selected
- Appearance — display the select with or without a border
- Spacing — display the select in Compact or Default mode
Macro Tutorial
To add Select on your page insert the Select macro:
To configure the Select macro, open configuration menu:
Configuration
To configure a Select macro, adjust the settings in the form on the right-hand side.
| Field | Description | Logic / Default |
|---|---|---|
| Type | Select mode | Values: Single, Multi. Default: Single. |
| Spacing | Control paddings | Values: Compact, Default. Default: Default. |
| Appearance | Visual style | Values: Default, None. Default: Default. |
| Placeholder | Greyed hint text | Optional. Empty by default. |
| Options | Inline options list | Required* if no attachment. Newline-separated. |
| Attachment | Load options from page attachment | Optional. If set, options are taken from file content (newline-separated). Download example |
Behavior
- State persistence: the Select remembers the last chosen value(s) on this page. Selections are saved with the page and restored on every open.
- Edit anywhere: you can change the selection in both view and edit mode;
- Single vs Multi: in Single mode a new pick replaces the previous one. In Multi mode options are added as tags; click a tag’s × to remove it.
- Placeholder: shown only when no value is selected; disappears as soon as at least one option is chosen.
- Options source priority: if both Options and Attachment are provided, the Attachment takes precedence. When the attachment content changes, options are reloaded on page refresh.
- Missing options: if a previously selected option is no longer present in the source, the previously saved value remains selected and continues to display until you choose another valid option.
- Appearance & Spacing: visual settings (Default/None, Compact/Default) affect rendering only; saved values do not change.