---
title: "Add a board to a page"
canonical: "https://support.appfire.com/space/CBCSL/642486290/Add%20a%20board%20to%20a%20page"
format: markdown
---
> Macro (aura-html)

### Board picker > Macro (anchor)



The **Insert Board** picker appears when you choose to add the macro.

![image](media://36e7b640-c321-4975-b4e4-76a63f1c9861)

The picker allows the choice from three groups of existing boards:

- <span style="color: #000000">**Featured Boards: **</span>insert from a selection of bundled boards
- <span style="color: #000000">**Popular Boards: **</span>view and select popular boards used by other users in the instance
- <span style="color: #000000">**Discover Boards:**</span><span style="color: #ff6600"> </span>boards currently available in [Boards Exchange](https://appfire.atlassian.net/wiki/spaces/CBCEL)

You can also choose to create a new board or [import a board](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641962881).

<span style="color: #000000">Choose </span><span style="color: #000000">**Discover Boards**</span><span style="color: #da673b"> </span><span style="color: #000000">to</span><span style="color: #da673b"> </span>browse a range of dynamic boards available in [Boards Exchange](https://appfire.atlassian.net/wiki/spaces/CBCEL).

![image](media://8eed4ac9-064c-469c-954e-401604c7c2ff)

### Insert a board

Choose the board you want to add to the page.

![image](media://ad3f3459-fe81-4052-bfcb-4f559c3480ee)

The board is displayed in the **Insert Board** dialogue box.

![image](media://bf132ab8-dcaa-4842-abee-a34c33d2f968)

- Choose **Insert** to add the macro to the draft page.

![image](media://208bae83-b180-4c30-bbd5-2f5e5ef57ba4)

Publish the board on the page by choosing **Update**.

![image](media://1de85984-620d-4d19-a39f-5735d5a19c9a)

- the board name is the same as the chosen board template
- the default display of the board includes the container descriptions

If the container descriptions are set as visible in the board properties, users can choose to hide the descriptions whilst viewing the board using the **Hide Descriptions** option of the board title dropdown menu.

![image](media://16301fb1-4fac-4377-8781-0cd40282a050)

[Cards can be added](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642225086) to the containers on the published board.

![image](media://cba8c070-d233-4187-8231-3987205609bc)

### Edit the board 

Each board can be customized. This includes options to edit:

- the look and feel of the board by adding rows, columns and headers
- the color scheme and icon for each container
- the name and description for each container

Choose **Edit** the page and select the option to **Edit** the board macro.

![image](media://6bfa9d57-4946-4704-9910-a2f20ef09cb3)

Use the **[Design board](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642191088)** tools in the **Edit Board** dialogue box to customize the board.

![image](media://4c77cf38-aeba-4745-9685-1d8c1aed0f08)

Choose **Board properties** to [edit the board properties](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641897581).

![image](media://cbf19c8e-61e5-45d6-af16-aeaa95abdf75)

Boards with the same name in a space are linked

- linked boards display the same information
- if cards change on one of the linked boards, all other boards are updated

If you need more than one copy of a board template in a space, you will need to change the name each time you add the board.

### Create and insert your own board

Instead of using one of the board samples you choose to create your own board.

Add the **Board** macro to the draft page.

![image](media://1b74ae1c-39ca-4b4a-aa2b-8d823db3a64a)

Select **Create your own board** in the **Insert Board** picker.

![image](media://aef6a94d-c4ba-4e38-a2af-e3086bac1a8e)

Drag your mouse and then click to define your board grid. 

![image](media://75ec8e70-c1a8-4397-a776-e7da24624f02)

Dragging and clicking your mouse to define the board grid opens the **Board design **option.

![image](media://86da92ba-fb25-4294-8b58-7985e16d90b7)

> ℹ️ You need to [edit at least one container](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642225388) to add a container name or a label to activate the** Insert **board button.

Mouse over a container and choose **Click to edit**.

![image](media://3a77109c-7b79-4934-b904-27d2cfe8a538)

Add a container name or just a label. Adding a container name will automatically add the name as a container label.

![image](media://cd718634-7eae-49d1-a6ce-a850b6772e19)

Choose **Apply** to add the changes to the container.

You can [edit the board](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641897581) further before inserting it on the page.

Use the **Design board** tool icons to [add a color scheme for each container or an icon](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641897382). Or add additional rows and containers.

Set [Board properties](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642486155) including name and [types of board cards](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641930243) that can be used on your board. Choose **Board properties** from the **Insert board** drop-down menu.

![image](media://6d7d1bb3-4bb8-43de-a483-6111e154266a)

Choose the now active blue **Insert** button to add your new board to the macro on the draft page.

![image](media://6b52ffa2-4013-4561-bdec-1e8a451d2f3c)

**Update** the page to view the board on the published page.

> ℹ️ Child pages of the current page with the added board with the same label as a container will be displayed as a card in that container. A child page without a label will be displayed as a board card in a container if the container has no label.
> ℹ️ 
> ℹ️ Find images and descriptions of available practical boards at [Boards Exchange](https://appfire.atlassian.net/wiki/spaces/CBCEL).

> ℹ️ **Related Links**
> ℹ️ 
> ℹ️ #### <span style="color: #003366">Related Pages</span>
> ℹ️ 
> ℹ️ - <span style="color: #003366">[What is a card?](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641930243)</span>
> ℹ️ - <span style="color: #003366">[Customize a board container](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/641930478)</span>
> ℹ️ - <span style="color: #003366">[Set board properties](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642486155)</span>
> ℹ️ - <span style="color: #003366">[Boards Exchange](https://appfire.atlassian.net/wiki/spaces/CBCEL)</span>
> ℹ️ 
> ℹ️ #### <span style="color: #003366">User Guide</span>
> ℹ️ 
> ℹ️ - [Comala Boards User Guide](https://appfire.atlassian.net/wiki/spaces/CBCSL/pages/642485706)
> ℹ️ 
> ℹ️ #### <span style="color: #003366">Help</span>
> ℹ️ 
> ℹ️ - [Forum](http://appf.re/support)
> ℹ️ - [Contact Support](http://appf.re/support)