---
title: "List Column Types"
canonical: "https://support.appfire.com/space/CBCSL/642453074/List%20Column%20Types"
format: markdown
---
> Macro (aura-html)

> Macro (legacy-content)

### Labels

#### Label Checkmark

Use the Checkmark column type to let users add or remove a single label.

To add the checkmark column type

- select the **Checkmark **column type
- enter the **Column Header**
- select an existing **label** or create a new one
- select a **Color **in the color-selection window then click

- choose **Accept**

![image](media://375250ab-d992-4f77-9076-3640557b1efd)

> ℹ️ The list row appears colored if the label is associated with a page.

#### Label Dropdown

Use the **Dropdown column type** to let users choose one of a group of labels for a page.

> 📝 By default, there is a blank selection included in the dropdown so the user can remove the label from a page.

To add a dropdown column type:

- select the **Dropdown **column type
- enter the **Column Header**
- aad a L**abel** name
- add the **Caption**

> ℹ️ The caption is the text that appears on the list dropdown menu when viewing the list.

- click **Accept** when all labels and captions are entered

### Page Information

**Properties**

To list the page properties

- select the **Properties **column type
- enter a **Column Header**
- select a **Page Property**
- choose **Accept**

### Metadata Column

> ℹ️ Comala Boards stores the metadata added through Boards Lists in the [Comala Metadata Format](https://marketplace.atlassian.com/plugins/org.andya.confluence.plugins.metadata). You can choose the [metadata storage model](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=COMALACM&title=Comala%20Metadata%20Macros) on the Boards Lists Configuration page.

> 📝 Metadata is organized as a **key:value pair**
> 📝 
> 📝 - the column header is the key
> 📝 - the value is what the user enters

Access and add to page metadata using these metadata column types

##### Dropdown

Select a metadata value out of a dropdown list.

To add a metadata dropdown column to the list:

- select **Dropdown** under **Metadata** column types
- enter a **Column Header**
- enter the dropdown choices in the **Options** field
- click **+** to add another option, or click **-** to delete an option
- click **Accept**

##### Text

A text column enables users to add single-line comments to a list.

> 📝 Wiki markup doesn't work in the text column.

To add a metadata text column to the list

- select **Text** under **Metadata** column types
- enter a **Column Header**
- enter the **Input Size**, which is the number of characters allowed
- click **Accept**

![image](media://1f62ec85-2d4f-45d0-bc38-a0a6ce9823d8)

##### Text Area

A text area column provides a text field in which users can enter [Confluence wiki markup](https://confluence.atlassian.com/display/DOC/Confluence+Wiki+Markup).

For example, entering `{cheese}` into the text area renders as 'I like cheese!'.

Use [common fields](#ListColumnTypes-common) to define the width and height in rows for the text area.

To add a** text area column** to a list:

- select **Text Area **under **Metadata** column types
- enter a **Column Header**
- enter the number of **Columns** and **Rows** to set the height and width of the text-area field
- click **Accept**

![image](media://fc4bc17e-70fb-41f2-b4f3-e4c5ee539336)

##### Reference

The Reference column retrieves the values displayed in another list column with the same header name. The value of existing metadata in each row is displayed **read only**.

To use the reference column type in a list:

1. Select the **Reference** column type.
2. Enter a **Column Header** that is the same as another column header in the list.
3. **Accept**.

![image](media://6c32eff0-4dc6-4469-9d6c-7338614860d6)

### Wiki Markup

Use wiki markup in a column to display page-specific information for each row.

To use wiki markup in a list:

- select the **Wiki Markup** column type
- enter a **Column Header**
- enter the wiki markup
- click **Accept**

For example, in an employee list, a wiki markup column with** !employee.jpg!** displays images with that file name attached to a page.

![image](media://31a5dc2d-778e-42ec-98e5-1dc4a335efa3)

### Common fields

These are common fields for all **Column type** options

![image](media://4408b3e8-c0fb-4da9-b9dc-a5f9eeeceb25)

- **Width**
  - define a column's width in pixels or percentage
- **CSS** **Class**
  - add the CSS class name
  - applies the CSS class rules that have been defined in the [Global Stylesheet](https://confluence.atlassian.com/display/DOC/Styling+Confluence+with+CSS)
- **Read** **Only**
  - check this box to restrict editing on this column