Content Formatting Macros for Confluence Cloud

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. 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 Working with 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.

  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.
    insert more
  4. Locate and select the required macro in the Select Macro screen, e.g. select Tabs Page.

    insert tabs
  5. Customize your content using the macro paramters.

    tabs page new
  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.

    tabs placeholder
  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.

    tabs macro rendered

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.