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

### [Example 5](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677729) Adding a column as a dropdown metadata Yes/No selection for each item

You can define a column as a selection.

Let's say we need to define whether or not the oviparous (the egg laying animals) are swimmers.

So we add the following list macros

- [list](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865) macro filtered by the label ***oviparous***
- [list-excerpt](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656578668) macro to display the classification in a column
- [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro with the values *yes* and *no*, for the last column of the list

> ℹ️ For the [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro that we did not select the checkbox for ***Use labels***, meaning that we are using a metadata value instead of a label.

![image](media://c89b8d53-55ab-4d4d-aaf1-f6ecd0f52c6b)

##### **Markup**

```
{list:label=oviparous|name=Swimmers|useboards=false} {list-excerpt:heading=Classification|width=10} {list-select:heading=Can swim?} Yes No {list-select} {list} 
```

This displays the following lists.

![image](media://b4faab3c-c950-470f-8f5e-2bd47db2b728)

  
The metadata value for the **Can Swim?** metadata can be accessed later using [list-attribute](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655988654) or any of the [Comala Metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM) macros.

![image](media://aae6d2df-f62f-4c9f-ac7d-14e6514c6e72)

For the [list-attribute](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655988654) macro, we indicate the ***attribute*** and the *page*. 

![image](media://eed155da-1188-43fe-bb87-db742bf98803)

If the page is left blank in the **Edit macro** dialogue box, the macro seeks the **Can Swim?** metadata value from the current page.

In our example, the metadata values are displayed for the page specified in each of the macros.

![image](media://32583d3f-39f1-48be-aa4d-77b891f34577)

> 📝 The example uses a Confluence table to display each question and the metadata value.

  
**Markup**

```
Can eagles swim? {checklist-attribute:attribute=Can swim?|page=Bald Eagle}

Can frogs swim? {checklist-attribute:attribute=Can swim?|page=Common Frog}
```

### Example 6 Adding a column as a dropdown label selection for each item

A [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro selection could use labels instead of metadata values.

Similar to [Example 2](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656579417), but in this example, the actual labels used are `bird`, `fish`, `mammal`, `amphibian `or `reptile` but each option could have a different value from the actual caption. 

For example, the caption for the label ***fish*** is *It's a fish*, or for ***bird*** is *It's a bird*. 

![image](media://6c6967cf-4d1b-415f-bad0-53207d8017cc)

In the body of the [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro each caption is defined as `<value>|<caption>.`

The  `<value>` is the actual label, the `<caption>` is the actual caption displayed.

![image](media://3a837f34-a873-4c38-bd39-8b084a6d42f7)

The markup for this example is

##### **Markup**

```
{list:label=oviparous|name=The oviparous|useboards=false} {list-select:heading=Type|uselabels=true} fish|It's a fish amphibians|It's an amphibian reptile|It's a reptile bird|It's a bird {list-select} {list}
```

### Example 7 Adding a column as a dropdown user selection for each item

Users can also be selected using the [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro.

You can configure the [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro using the **Edit macro** dialogue box.

![image](media://ae8d6569-0643-4874-8f5e-f5e0e86d1a2e)

Users can be added as choices in the drop-down menu on the page by either:

- using a Confluence group name to allow selection from the users who are members of the group
- using ***all***** **to allow selection among all the existing users in the instance

![image](media://c2323bcc-dfdf-48a8-a32f-0b87d9b8254f)

![image](media://2fa43f93-8ced-4787-97dc-5dd42e4f7e16)

**Markup**

```
{list:label=pets|name=Alpha Centauri Pets|useboards=false} {list-select:heading=Lead Owner|usersgroup=all} {list-select} {list}
```

In the [list-select](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656676955) macro

- if there is only one option to select from ***and ***`store` is set to `checklist`

![image](media://049e3286-c9a9-4b88-98ac-040df406da28)

- then the column is handled as a checkbox

![image](media://5ded5bd8-9be7-4246-8faf-902fe2a198aa)

*Further details are in **[Example 11](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656677412)**.*

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