What are Confluence macros? Create beautiful Confluence pages now (2023)

6 minute read


emma schmidt

August 19.21confluence

What are Confluence macros? Create beautiful Confluence pages now (1)

adaptavist-logo IconAdaptavista

What are Confluence macros? How to use them to create beautiful Confluence pages

subscribe to

Related Posts

8 Feb 23 How to create a Confluence knowledge base ...arrow icon1 Feb 23 How a Confluence knowledge base can benefit...arrow iconDec 8, 22 App News: Confluence reviews are in... arrow icon
Show all blogsArrow icon

Share this blog on your social networks

Confluence is a brilliant platform for any company looking to improve collaboration and enhance knowledge sharing. if you areCreation of an internal wikior brainstorm with colleagues around the world, Confluence is a remote-friendly content platform that empowers your team to do their best work.

Not all Confluence pages are the same

Confluence has thousands of customers around the world, but not all of them use the tool perfectly or to its full potential. When Confluence spaces are not set up and managed correctly, users can find it difficult to navigate and find the information they need, while administrators can struggle to onboard users quickly and help teams get the most out of the tool.

For this reason, many organizations turn to Confluence's editing tools, also known asConfluence-Makros. Whether it's to visually enhance the way content is displayed, structure content more clearly, or completely change the functionality of a page, using Confluence macros can help anyone unleash the true power of Confluence. To get started with Confluence macros:


What are Confluence macros? Create beautiful Confluence pages now (5)

Find out how you can use Confluence to improve collaboration in your business

With numerous use cases and customization options, Confluence is a flexible and adaptable tool for teams of all sizes.

keep reading

(Video) Creating Beautiful Confluence Pages

What are Confluence macros?

Confluence macros are also known as plugins and plugins. They are tools that canextend functionalityand Confluence content design. Available natively in Confluence and also as free or paid apps on theAtlassian Market, there are hundreds of macros you can use to customize your Confluence pages.

Confluence macros generally require more sophisticated setup than the basic Confluence functionality you see on the main toolbar. But don't let the slightly more complicated application put you off. Confluence macros can be incredibly powerful and take your pages and spaces to a whole new level.

Application example:Your team is working on a new project. He works remotely and needs to collaborate in real time, and he wants the project space to be as engaging and visually appealing as possible. Confluence macros allow you to add additional features and design elements, such as buttons, cards, footnotes, and expandable sections. This, in turn, can help improve communication and collaboration, allowing your team to work more efficiently and effectively.


Find out how to use Confluence macros to transform a Confluence page in just five minutes.

How to use Confluence macros

Using Confluence macros requires a bit of knowledge, but once you know where to find them and the information you need to set them up, you'll be creating beautiful Confluence pages in no time.

Note: The steps for inserting Confluence macros, and the selection of the macros themselves, vary between Confluence Cloud and Confluence Server/Data Center.

Below is the process of inserting macros in Confluence Cloud.

How to add a macro in Confluence Cloud

  • On the page you want to add a macro to, click the pencil icon to open the Confluence editor.
  • Click the + button in the upper right corner of the Editor toolbar, then click Show More.


What are Confluence macros? Create beautiful Confluence pages now (6)

  • On the browse screen, select a macro from one of the sections provided. You can also use the search bar to search by the name of the macro you want to use (for example, "Confluence content formatting macros") or by functionality (for example, "button" or "tabs"). If you can't see the macro you're looking for, you may need to download it fromAtlassian Marketor wherever you get your Confluence apps.


What are Confluence macros? Create beautiful Confluence pages now (7)

  • Click the macro you want, then click Insert. This will add a macro placeholder to your page, which you will then need to edit (double-click the macro placeholder) to add your information and parameters. This varies from macro to macro, so check thosedocumentationfor the application you are using.

Pro Tip: When editing a Confluence Cloud page, you can only type/on the page to bring up the macro selection. If you are using Confluence Server or Data Center, enter{


Get the most out of Confluence with these advanced native macros

Confluence comes with native (built-in) macros, which are available by default with every trial and license of Confluence. There is also a wide range of advanced third-party macros that you can try and buy to add more powerful functionality. These third-party Confluence apps can be found atmercado- Easily filter by product and type of accommodation.

Looking for macro inspiration? Check out this selection of popular and powerful Confluence macros:

(Video) Create beautiful pages | Confluence | Atlassian


Native Confluence macros (built into Confluence)

Table of Contents Macro:

you can add oneTable of Contents Macroto every page in Confluence and provides you with an easy-to-read summary of information to quickly show readers what to expect on a page. If you have a lot of content and want to help your users navigate through large chunks of text, a table of contents is a quick and easy solution.


What are Confluence macros? Create beautiful Confluence pages now (8)

Expand macro:

Heenlarge macroallows you to place content in expandable and collapsible sections within a page. Visually reduce the amount of information you have on a page and encourage users to interact with it. You can find this macro in the "Format" category of the macros menu in Confluence.


What are Confluence macros? Create beautiful Confluence pages now (9)

Roadmap planner:

HeRoadmap-Planner-MacroIt acts as a project timeline, or roadmap, to visualize the lifespan and progress of a project or task. It is available in the Graphics and Images category of the macro menu.


What are Confluence macros? Create beautiful Confluence pages now (10)

Page Properties Macro:

HePage properties macroworks with the page properties report macro to extract information from specific pages and display it in an easy-to-read table. It's useful for project updates and status reports, as you can see the most relevant information collected from different pages on a single page.


What are Confluence macros? Create beautiful Confluence pages now (11)

What are Confluence macros? Create beautiful Confluence pages now (12)

Read more about how to create better Confluence pages in our guide.

We've rounded up everything you need to know to make your pages stand out.

read instructions

(Video) Build beautiful & smart pages | Confluence | Atlassian

Confluence macros and advanced tools (3rd party plugins)

Content Formatting Macros for Confluence

The Confluence Content Formatting Macro Set offers 12 powerful macros for the cloud and 43 for servers and data centers. The macro collection helps improve the design, functionality, and user experience of Confluence content, extending its functionality and giving users the tools to create better documentation, wikis, knowledge bases, and brand pages.

Here are some of the more popular Content Formatting Macros for Confluence:


HeConfluence-Tooltip-Makrois a simple macro that allows you to add details to a page without cluttering it with additional text. Tooltips allow you to display text to users when they hover over or click the tooltip icon, making it ideal for referencing or adding additional context for users who want more information. See it in action below:


Start with the tooltip macro

macro tab

eyelashesis an extremely simple yet effective macro that does what its name suggests: it adds tabbed content to a Confluence page. This allows you to organize the information into sections that users can navigate to and click on. This is great for breaking up large blocks of text and keeping pages organized and neat.


What are Confluence macros? Create beautiful Confluence pages now (13)

map macro

Available as part of the content formatting macros for Confluence Cloud, themap macrois one of the most popular ways to add layout styling to a Confluence page. Use it to add maps to pages with images, text, and even hyperlinks. It's great for team profiles, homepage menus, and blogs, and helps make Confluence content look more like a professional website.

Ready to add these macros to your Confluence site? Click below to try Confluence content formatting macros for free.

Try Confluence content formatting macros for free


What are Confluence macros? Create beautiful Confluence pages now (14)

Forms for Confluence

Conduct surveys, ask users for feedback, and cooperate with business processesForms for Confluence. Available in the cloud, server, and data center, the Confluence Forms Macro allows you to create and embed forms directly in Confluence. It is easy to use, secure and responsive. Learn more about how Forms for Confluence can benefit your business in ourthe blog.


Community Forums for Confluence

Encourage your team to participate in discussionsCommunity Forums for Confluence. This app helps boost collaboration and engagement by adding forums directly to your Confluence pages. This app is available on all hosting platforms.

(Video) What Are Confluence Macros – Confluence Tutorial


What are Confluence macros? Create beautiful Confluence pages now (15)

Try Confluence's content formatting macros for free!

Do you like the sound of content formatting macros? You can try all of them right away without paying a dime. Click below to start your free trial of this powerful app and make your Confluence pages look better than ever!

try it free

About the authors

emma schmidt

Emma is a Senior Content Marketing Manager specializing in Hierarchy for Jira, Content Layout Macros for Confluence, and Forms for Confluence.

keep reading


February 8, 23

How to create a Confluence knowledge base in six easy steps

February 1, 23

How a Confluence knowledge base can benefit your business

8 December 22

App News: Confluence ratings will be suspended

5 December 22

How to create forms in Confluence Cloud for data collection

(Video) Using a Page Macro in Confluence Tutorial


1. Tabs for Confluence Cloud | Content Formatting Macros for Confluence (2022)
(Adaptavist Enterprise)
2. Create Engaging Confluence Pages with Cards & Panels
3. Confluence Tutorial #8 - Macros in Confluence
(RCV Academy)
4. Confluence Macros - Roadmap Planner
(Jimi Wikman - The Holistic Consultant)
5. Templates in Confluence - How to use Macro Templates | Aura for Confluence Cloud
6. Add a macro in Confluence | Atlassian
Top Articles
Latest Posts
Article information

Author: Prof. Nancy Dach

Last Updated: 02/19/2023

Views: 5986

Rating: 4.7 / 5 (77 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Prof. Nancy Dach

Birthday: 1993-08-23

Address: 569 Waelchi Ports, South Blainebury, LA 11589

Phone: +9958996486049

Job: Sales Manager

Hobby: Web surfing, Scuba diving, Mountaineering, Writing, Sailing, Dance, Blacksmithing

Introduction: My name is Prof. Nancy Dach, I am a lively, joyous, courageous, lovely, tender, charming, open person who loves writing and wants to share my knowledge and understanding with you.