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. You can use these macros individually, or combine them to develop your content customization, for example, add a Button Hyperlink macro to a Tabs Page macro.

These macros have been created to work with the latest Confluence Cloud editor and to support the same macros migrated from Content Formatting Macros Server or Data Center. 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. To learn more about general macro use and the Confluence editor, please consult Atlassian’s Cloud macro documentation. If you are working with content migrated from Confluence Server or DC to Confluence Cloud, see the Support for Migrated Content section of our documentation.

If you already use Content Formatting Macros for Server or Data Center and are moving to Cloud, please be aware that the Cloud versions of our macros do not support macro parameters such as ID, Class, and Custom Icons.

Add a macro

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 simply press e on your keypad to switch to Edit view.

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

    Speed up adding macros with a keyboard shortcut by typing / and the beginning of the macro name to display a list of matching macro names, e.g. /tabs.

    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 is displayed 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 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.

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

  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.