Description

Allows selection of one or more options from a specific list.

Must contain option-generating sub-macros (e.g. List Option or Content Options).

Parameters

Name	Available In	Default Value	Description
name (Field Name)	Server, Data Center		The name of the field. Must be unique.
type	Server, Data Center	select	The type of field to display. May be one of the following: select - A selectable list is displayed check - A list of checkable items are displayed. Auto Complete - An auto complete list is displayed. Note: Only applies for forms mode.
required	Server, Data Center	false/unchecked	If `true`, a non-empty item must be selected.
multiple (Allow Multiple)	Server, Data Center	false/unchecked	If `true`, multiple options may be selected.
separator	Server, Data Center	comma	If multiple items are selected, the type of separator to display between each item. Defaults to one item per line. May be one of the following: bracket - Square brackets ('[', ']') surrounding each item. brace - Braces ('{', '}') surrounding each item. comma - A comma (',') between each item. paren - Parentheses ('(', ')') surrounding each item. pipe - A pipe ('\|') between each item. newline - A line break after each item. "custom" - Any other character you wish, specified between quotes.
customSeparator	Server, Data Center		What you wish to use as a separator, only used when custom is selected for Separator.
blank	Server, Data Center	true	If 'true', a blank item is added to the list. Only applies to 'select' lists. If the user saves while selecting the blank item and the list is 'required', the page cannot be saved. Note: Only applicable for forms mode.
blankText	Server, Data Center		If specified, and 'blank' is true, this text will be used for the blank option label. Note: Only applicable for forms mode.
width	Server, Data Center		The width of the field. Any CSS width is allowed (e.g. 100px). Note: Only applies when type is 'select'. Note: Only applies for forms mode.
height	Server, Data Center		The height of the field. Any CSS height is allowed (e.g. '20px'). Note: Only applies when type is 'select'. Note: Only applicable for forms mode.

Editor View

Tutorial Examples

Page:

Populating a List with Confluence Pages
Page:

Using Attachments as Options
Page:

Using Confluence User Names as Options
Page:

Creating a Simple Form
Page:

Creating a Dynamic Table
Page:

Tracking Workflow Status
Page:

Grouping and Retrieving Data
Page:

Collecting and Displaying Data in a Structured Way
Page:

Adding Labels to Pages Automatically
Page:

Creating a Checklist with Special Characters
Page:

Creating a Project Details Form