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.

    The Insert dropdown with the View More option highlighted.

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

    The Select Macro screen with Tabs Page highlighted.
  5. Customize your content using the macro parameters.

    The Insert Tabs Page Macro screen with an example configuration.
  6. Click Insert. A macro placeholder displays on the page. To preview how the macro will appear on your page before inserting it, click Preview in the Insert Macro screen.

    A placeholder for the example Tabs Page macro.
  7. Add your content to the macro body. Insert any additional macros on your page as described above, e.g. additional tabs pages.

  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, then click Save.

Delete a macro

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