Introduction To Macros

What are Macros?

Macros are powerful tools in Confluence that allow users to automate repetitive tasks and enhance the functionality of their pages. A macro is essentially a piece of code that can be inserted into a Confluence page to perform specific functions, such as displaying dynamic content, embedding other applications, or manipulating data in real-time.

Why Use Macros?

Using macros can significantly improve productivity by reducing the amount of manual work needed to create and manage content. Some benefits of using macros include:

Automation of repetitive tasks.
Dynamic content updates.
Integration with other tools and applications.
Enhanced page design and layout options.

Types of Macros

There are several types of macros available in Confluence, each serving a unique purpose. Common types include:

Content Macros: These macros allow you to include various types of content, such as images, videos, or other pages.
Formatting Macros: These help in formatting content, like adding tables, layouts, or custom styles.
Integration Macros: These enable you to connect Confluence with other applications, such as Jira or Trello.

How to Insert a Macro

Inserting a macro into a Confluence page is simple. Follow these steps:

Open the Confluence page where you want to add the macro.
Click on the "+" icon in the editor toolbar.
Select "Other Macros" from the dropdown menu.
Choose the desired macro from the list or search for it using the search bar.
Configure the macro settings if necessary and click "Insert".

Here’s an example of how to insert a Page Include macro:

1. Click on "+" > Other Macros > Page Include

2. Enter the name of the page you want to include.

3. Click "Insert".

Example of a Macro

Let’s say you want to display a list of recent blog posts on your page. You can use the Blog Posts macro to automatically pull this information. Here’s how you can do it:

1. Click on "+" > Other Macros > Blog Posts.

2. Set your parameters (like number of posts, labels, etc.).

3. Click "Insert".

After inserting, the macro will automatically display the latest blog posts based on your settings.

Output: A dynamic list of recent blog posts will appear here once the macro is inserted.

Conclusion