Exploring built-in Confluence macros - Confluence Tutorial

Welcome to this tutorial on exploring built-in Confluence macros. Confluence provides a wide range of macros that allow you to add dynamic and interactive elements to your pages. Macros are pre-built functionalities that can be inserted into your Confluence pages to enhance content and improve collaboration. In this tutorial, we will delve into the different types of built-in Confluence macros and learn how to use them effectively.

php Copy code

Introduction to Confluence Macros

Confluence macros are powerful tools that enable you to add various functionalities to your pages without requiring any programming knowledge. Macros can be used to display dynamic content, generate reports, embed media, create interactive elements, and more. Confluence offers a wide range of built-in macros that are ready to use out of the box.

Types of Built-in Confluence Macros

Confluence provides a variety of built-in macros to suit different needs. Some of the commonly used macros include:

  • Include Page Macro: Allows you to include content from another page or space within your current page. This is useful for reusing content or creating dynamic templates.
  • Panel Macro: Lets you create visually appealing panels to highlight and organize content. You can choose from different panel styles, such as info, warning, note, and more.
  • Table of Contents Macro: Automatically generates a table of contents based on the headings in your page. This helps users navigate through long documents easily.
  • Chart Macro: Enables you to create charts and graphs to visualize data. You can choose from various chart types, including bar, line, pie, and more.
  • Task List Macro: Allows you to create checklists and track progress on tasks. You can mark tasks as complete or incomplete, assign due dates, and add descriptions.

Using Built-in Confluence Macros

Here are the steps to use built-in Confluence macros:

  1. Open the Confluence editor and navigate to the page where you want to add a macro.
  2. Click on the "+" icon in the toolbar to open the macro browser.
  3. In the macro browser, you can browse through different macro categories or use the search bar to find a specific macro.
  4. Select the desired macro from the list and configure its parameters as per your requirements.
  5. Click "Insert" to add the macro to your page. The macro will now be displayed with its configured settings.
  6. Continue editing the page and save your changes when you're done.

Common Mistakes

  • Using macros without fully understanding their functionality and limitations.
  • Overusing macros, which can clutter the page and make it difficult to read and navigate.
  • Not configuring macro parameters correctly, leading to undesired results.

Frequently Asked Questions

  1. Can I customize the appearance of a macro?

    Yes, many macros offer customization options. You can adjust parameters such as size, color, style, and more to suit your requirements.

  2. Can I create my own macros in Confluence?

    Yes, Confluence provides an API that allows you to develop custom macros using programming languages like Java or JavaScript. However, creating custom macros requires programming skills.

  3. Can I nest macros within each other?

    Yes, you can nest macros within each other to create complex and interactive content. However, be cautious and ensure that the nesting doesn't affect the readability and usability of the page.

  4. Can I share macros with other users?

    Macros are shared with other users when you share the page. However, users need appropriate permissions to view or interact with certain macros, such as editing a task list or configuring a chart.

  5. Can I export pages with macros?

    Yes, when you export a Confluence page, the macros are included in the exported file. However, the functionality of the macros may depend on the system you import the file into.


In this tutorial, we explored the different types of built-in Confluence macros and learned how to use them effectively. Macros offer a convenient way to add interactive and dynamic elements to your pages without any programming knowledge. By understanding the functionality of each macro and following best practices, you can enhance your Confluence pages and create engaging content. Avoid common mistakes such as overusing macros or misconfiguring their parameters. Experiment with different macros to find the ones that best suit your content and collaboration needs.