---
title: "Add the list macro to a page"
canonical: "https://support.appfire.com/space/CLSL/656676281/Add%20the%C2%A0list%C2%A0macro%20to%20a%20page"
format: markdown
---
> Macro (aura-html)

![image](media://59d84355-3d32-4d54-a1d2-a1615733a23e)

## Add the **list** macro to a page

The [list](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865) macro can be used on its own or together with other **Comala List** macros.

> ℹ️ All **Comala List** app macros (except the [list log](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655758688) macro) are added to the body of the [list](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865) macro. Each added list macro defines a column displayed on the page.

## Adding the macro

On a Confluence page with child pages:

![image](media://bf90c8a4-14b5-4579-b541-7b0b28ac21ec)

- Add the [list macro](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865) to the parent page

![image](media://8f3e3966-9c0a-4e33-9631-a21fa800c3c3)

- **Update** the page to save the change

The macro displays a single-column list on the published page.

![image](media://500b78eb-aa6e-4b06-b7e4-d2ad4607c81c)

<span style="color: #333333">The macro displays the child pages of the parent page in a column.</span>

> ℹ️ The list macro default for the parent page is the current page (the page containing the list macro).

<span style="color: #333333">The macro can be edited to filter the display by content label.</span>

![image](media://ffa4edfd-25c6-4b25-b87a-df3899afd527)

If no name is entered to the **Name** field in the **Edit macro** box, the default name for the list is the title of the page to which the macro has been added.

![image](media://116ad581-5c6a-4d0e-8071-fc662dd98e8e)

Further columns can be added to the list by

- Editing the [list ](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)<span style="color: #172b4d">[macro](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)</span> in the macro editor
- Including other **Comala List** macros within the body of this [list ](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)<span style="color: #172b4d">[macro](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)</span>

> ✅ You will find all the information regarding each of the Comala List macros in the [macro guide](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=clsl&title=User%20Guide&linkCreation=true&fromPageId=656676281).

These list columns can be used to

- Display, manage, and add labels
- Display, manage, and add metadata
- Show [page excerpts](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656578668)

## Related pages

- [list macro](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655889865)
- [Creating list macro columns using other macros](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656580076)
- [Examples- list macro](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/656579417)