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

Defines a column as a label.

![image](media://de34abb1-8afe-4609-a42c-a9b48d247b4c)

<span style="color: #172b4d">The  </span>`list-label `<span style="color: #172b4d">macro is added to the checklist macro to define a label column for the list.</span>

![image](media://4a8a6141-ccbb-4dc5-9c8a-124ec5948b88)

<span style="color: #172b4d">The label for the column can be an existing label or you can create a new label. The displayed column heading can be set to be different to the label name.</span>

![image](media://cce7651c-216f-4da1-892c-0321b1d76641)

Every time a cell of this column is selected on the page, the label will be added/removed to/from the referred page. See [Example 4](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655891543).

### Parameters

| parameter | Mandatory? | Default | description |
| --- | --- | --- | --- |
| `heading` | yes |  | The heading of the column |
| `label name` | yes |  | The label to be used to 'check' the pages |
| `width` | no |  | width of the column |
| `display as readonly` | no | `false` | whether or not the column is read-only |
| `CSS class` | no |  | the style sheet (CSS) class to use for the cells |

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