Macros Overview

Content Formatting Macros is a set of macros that enable you to customize the look and feel of your Confluence Cloud content and improve user journeys. 

Macros are elements that add formatting, navigation, or additional functionality to your pages. To learn more about each macro, see the individual macro pages in our documentation. The section below explains how to access and insert the macros on a page. To learn more about general macro use and the Confluence editor, please consult Atlassian’s Cloud macro documentation.

Migrating from Confluence Server/DataCenter to Cloud?

Our macros have been created to work with the latest Confluence Cloud editor and to support our macros migrated from Content Formatting Macros Server/Data Center. See the Support for Migrated Content section of our documentation for a list of supported macros and more on what to expect when migrating content.  If you are working with migrated content, you will initially be viewing your content in Confluence's Legacy editor. More on the differences between the Legacy and new Cloud editors can be found in Atlassian's knowledge base article.

Add a macro to a page

The methods for adding macros described below apply to Confluence’s new Cloud editor. 

To add a Content Formatting macro to a Confluence page, complete the following steps:

  1. Navigate to the page you would like to edit.

  2. Click the Edit icon in the top-right of the page, or press `e` on your keypad.

  3. Select Insert > View More in the Confluence editor.

    Alternatively, use the keyboard shortcut by typing / and the beginning of the macro name to display a list of matching macro names, e.g. /tabs. You can discover more Confluence Cloud keyboard shortcuts by selecting Keyboard Shortcuts from the Confluence Help menu.

  4. Locate and select the required macro in the Select Macro screen, e.g. select Tabs Page.

  5. Customize your content using the macro parameters.

  6. A macro placeholder displays on the page. 

  7. Add your content to the macro body. Insert any additional macros on your page as described above, e.g. additional tabs.

  8. Click Publish to see the macro rendered on the page.

    The rendered example of a Tabs Page macro.

Edit a macro

To edit a macro, complete the following steps:

  1. Navigate to the page you would like to edit.

  2. Click the Edit icon in the top right of the page to display the page in Edit mode.

  3. Click the macro placeholder, then click the Edit icon. The Edit Macro screen displays.

  4. Make the required changes.

Delete a macro

To remove a macro from a page, click the macro placeholder, then click the Trash icon.