---
title: "List select"
canonical: "https://support.appfire.com/space/CLSL/656676955/List%20select"
format: markdown
---
> Macro (aura-html)

> Macro (legacy-content)

Add the `list-select` macro

The  `list-select` macro is added to the body of the [list](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)` `macro to create a drop-down selection column in the list on the page.

![image](media://2d046e63-3937-442e-bec8-ef698aa0bee3)

<span style="color: #333333">The drop-down selection is configured in the </span><span style="color: #333333">**Edit **</span>**'List select' **<span style="color: #333333">**macro**</span><span style="color: #333333"> dialogue box.</span>

![image](media://b7685b1a-98db-44ec-b811-0280ec127a61)

> ℹ️ <span style="color: #333333">If </span><span style="color: #333333">**Use Labels**</span><span style="color: #333333"> is not checked and no </span><span style="color: #333333">**Users group**</span><span style="color: #333333"> is specified, a list of options for the selection can be added to the macro body.</span>

#### Use labels for the drop-down selection options

<span style="color: #333333">Checking </span><span style="color: #333333">**Use Labels**</span><span style="color: #333333">, will allow the choice of existing labels from the </span><span style="color: #333333">[list](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)</span><span style="color: #333333"> content to be added to the macro body to be used as the drop-down selection options. Content in the list that has one of these labels will show the label pre-selected in the drop-down selection.</span>

![image](media://ad2f58ca-bd9f-4147-94f3-3c71ab4e7ed4)

> ℹ️ If labels are used, changing the drop-down selection will update the label on the linked page.

#### User group members for the drop-down selection options

<span style="color: #333333">Adding a Confluence user group to </span><span style="color: #333333">**Users group**</span><span style="color: #333333"> in the </span><span style="color: #333333">**Edit macro**</span><span style="color: #333333"> dialogue box will populate the drop-down selection with the group members.</span>

![image](media://9daff0cd-daa0-41cd-9cf3-9186733b4141)

#### Configure access and storage of the column values

The `list-select` macro can be configured so

- the column values to be read-only
- the column values are stored with the row entry page or stored in the page containing the list

The values can be accessed as metadata values (see the **Parameters** table below).

See [Examples 5, 6 and 7](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677729).

### Parameters

| parameter | Mandatory? | Default | Description | Comment |
| --- | --- | --- | --- | --- |
| `heading` | yes |  | The heading of the column |  |
| `use labels` | no | `false` | Instead of setting a metadata value, add the selected label |  |
| `users group` | no |  | Instead of listing the value, use the given users group to select from a list of users. Use `all` for listing all the users | <span style="color: #000000">Not available with Comala Boards</span> |
| `storage type` | no | `rows` | Determines where to store the value. Use `rows` to store the values for this column into the pages representing each row (metadata value name is `<Column Heading>`), or `checklist` to store the values into the page containing the checklist (metadata value name is `<Column Heading>.<Space Key>:<Row page title>`) | `store=checklist` not supported with Comala Boards |
| `sorttype` | no | `S` | Type of value to be used to sort the table by this column. Values could be any of A: Already sorted; C: Currency; D: Date; F: Float; I: Integer; S: String |  |
| `width` | no |  | Width of the column |  |
| `readonly` | no | `false` | Whether or not the column is read-only |  |
| `CSS class` | no |  | The style sheet (CSS) class to use for the cells |  |
| *macro body* |  |  | If no `usersgroup` is given, the options to select from have to be defined as part of the body. Each line of the body defines an option. Each option could have a different value from the actual caption by defining it as `<value>|<caption>` . See [Example 5](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677729) and [Example 6](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677729). |  |

| [Back to Comala Lists User Guide](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=clsl&title=User%20Guide&linkCreation=true&fromPageId=656676955) |
| --- |
| ### [list select examples](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677729) |