--- title: "Get started with Comala Boards for Confluence for Cloud" canonical: "https://support.appfire.com/space/CBCCL/642486984/Get%20started%20with%20Comala%20Boards%20for%20Confluence%20for%20Cloud" format: markdown --- > Macro (aura-html) ### What is a board? A Comala Board is a fast and effective way for you to brainstorm and visualize your content and ideas.  A board can be embedded in an existing page by adding the board macro.  Several board templates can be used to help you get started, such as the [SWOT Analysis board](https://appfire.atlassian.net/wiki/spaces/CBCCL/pages/641998054). ![Comala Boards Cloud SWOT analysis board displayed on Confluence page with four quadrants](media://1e274f14-38ff-465c-8b49-2a5d60a21a52) An existing board template can be customized, or you can create your own board. ![Comala Boards Cloud custom tasks board with onboarding tip overlay for new users](media://8c7de852-9b38-4542-ac9c-8fe9ab7c29ce) ### Add a board to a page - **Edit** a Confluence page - Select the **Comala Boards macro** to add the macro to the draft page - Choose an existing board in the board picker to add to the page ![Comala Boards Cloud insert board dialog with Agile template selection highlighted](media://1a078106-1aea-4d4a-8ba8-b86c2a819f9b) > ℹ️ Available boards are displayed under different categories. Choose a board to view the board outline details. ![Comala Boards Cloud insert board dialog showing MoSCoW prioritization template option](media://f73db43c-12df-40f9-8fa1-a3e56c3dddbb) > ℹ️ Boards are available for task management, strategic business frameworks, and agile processes. Choose **Insert** to add the board to the macro on the draft page. ![Comala Boards Cloud board macro editor displaying MoSCoW template configuration settings](media://8bc195fb-0c56-4173-8405-3bcc4e8f9bf5) If you want to edit the board macro before adding it to the published page - **S*****elect the pencil tool*** to open the board editor - And if required, customize - The board layout - Container names - Icons - Colors Choose **Publish** to add the board to the published page. ![Comala Boards Cloud MoSCoW prioritization board on page without cards added yet](media://830d8504-a559-4a98-be72-d4cdd3fd4295) Cards can be added to the board by users without the need to edit the page. Users can also drag cards between cells (or containers) on the board. ![Comala Boards Cloud MoSCoW board with sample cards populated in priority columns](media://a2c94880-edd5-4af7-81b3-7e232591bb8e) Moving a page-card (card linked to a page) between containers on the board changes the label(s) of the linked page to those of the new board container. Click a container name on the published board to display the container description and any container labels. ![Comala Boards Cloud container with description and label fields for customization](media://7891823e-2590-43e8-9a6f-07bcc44cb53a) ### Adding cards to a board Cards can be added to any container on the board by users. > ℹ️ Cards can be simply [cards](https://appfire.atlassian.net/wiki/spaces/CBCCL/pages/641997997) on the board or [page-cards](https://appfire.atlassian.net/wiki/spaces/CBCCL/pages/641997936) with a linked Confluence page. ![Comala Boards Cloud custom tasks board populated with task cards in different columns](media://c6766f7d-e747-4c49-907c-1dc5c1a60847) ### Add a card Choose a container and either: - Hold the pointer over the top right corner and select the plus symbol **+** - Double-click the body of the container ![Comala Boards Cloud add card interface showing options to create new board items](media://513cde35-31b9-4e51-a06b-b02eee8aeb7d) Type the name required for the new card. Choose **Add**. ![Comala Boards Cloud add card dialog with title and description input fields](media://ca5e6fb7-1265-417e-a8af-59397b624288) ### Add a page-card If a page exists in the current space with the proposed card name, you can select the suggested page to add as a card title ![Comala Boards Cloud add page card dialog for linking existing Confluence pages](media://7dd2bd69-c33c-4368-973e-f5371e3330fc) Choose **Add** to add the card to the container. The new card is hyperlinked to the page as a [page-card](https://appfire.atlassian.net/wiki/spaces/CBCCL/pages/641997936).  ![Comala Boards Cloud board showing newly added page card integrated into layout](media://ae9c0ed6-0b23-403b-bbd6-f64421ebd2de) > ℹ️ An option is provided to search for page names in other spaces. ### Converting an existing card to a page-card with a linked Confluence page Existing cards on the board can be converted to a page-card to create a linked Confluence page as a child page to the current page. ![Comala Boards Cloud card conversion menu option to transform card into page](media://29bce7e3-d51f-4022-9f78-8a60e5fd032c) Then choose **Convert to page**. ![Comala Boards Cloud convert to page dialog for creating Confluence page from card](media://30be6679-e6dd-4663-b7f5-4d274494cfd6) Page-cards can also be created from existing Confluence pages in the space. ![Comala Boards Cloud add card from existing page dialog with search functionality](media://e6e2e870-4e88-489f-9a43-d652efdefc74) Type the first letters, and the possible options for a page to be linked to the card will be listed. ### Edit a card - Choose a card to edit the contents of the card - Add or amend card contents - Choose the tick to confirm > ✅ If you add a soft return (*shift/return*) to create a new line of text in the card, only the first line is displayed on the card on the board. Mouse over a card on the board to see any additional text (if present). You cannot edit a page-card contents. However, any change in the title of the linked page is reflected in the card name on the board. ### Remove a card To remove a card from the board - Hold the pointer over a card - Choose the trashcan icon ![Comala Boards Cloud card with trash icon for deleting cards from board](media://d0bc0139-9568-4e61-86d3-133399ba395b) Then choose **Remove**. ![Comala Boards Cloud card removal confirmation dialog with delete options](media://324c75ad-6f81-432d-a1fc-6760eda13a2f) > 📝 Removing a page-card does not delete the linked Confluence page or change the labels of the previously linked page.