Document toolboxDocument toolbox

This article is for Data Center. Visit Cloud

Confluence Macro

Owned by Su-Lyn Rosenberry
Last updated: Oct 11, 2024 by Jaramy Conners
3 min read

The Structure macro for Confluence allows you to add a functional structure to any Confluence page.

Confluence page with a Structure macro

Adding a Structure Macro to a Confluence Page

When editing a Confluence page, select the Insert Macro button, and search for Structure.

Adding a Structure macro to a Confluence page

Configure the following options:

  • Jira application - If you have more than one Jira linked to your Confluence, select the instance you want to use.

  • Structure - Select the structure you want to include on your Confluence page.

  • View - The selected view determines which columns the macro displays. (You can adjust the view later.)

  • Filter Type - Filter the issues in the structure using a text filter, JQL, S-JQL, or a saved filter.

  • Title (optional) - Add a title to the macro. By default, the name of the structure is used.

  • Width (optional) - Specify how wide the macro should be in pixels.

  • Height (optional) - Specify how tall the macro should be in pixels.

  • Allow changes (optional) - Select this option if you want Confluence viewers to be able to edit the structure and issues (based on their Jira credentials).

Having trouble?

  • Make sure your Confluence administrator connected Structure and Confluence.

  • If you’re not currently logged in to the selected Jira, you will be asked to log in before you can add the macro. 

Using the Macro

The macro provides most of the functionality available when working in Structure directly, including:

  • Inline editing - see Editing from Gadget for a list of fields that can be edited from the macro

  • Moving issues

  • Deleting issues

  • Adding/removing columns

  • Text wrapping and horizontal scrolling

Some of Structure's features are limited or unavailable in the macro:

  • Search and the Secondary panel are unavailable

  • The toolbar is unavailable

  • The displayed Structure macro is not suitable for printing. We suggest using Printable Page to print a structure separately.

Customizing the Macro View

Once you have created your macro, you can customize it by adding, removing, or rearranging columns.

After you’ve made your changes, you can save the updated view, or select Revert to return to the original view.

You must have Update permission for the current view to save changes.

Open the Structure

Working directly from the Structure Board provides the most unrestricted Structure experience. To get to the Structure Board from a macro, click the Open link.

The structure will open on the Structure Board with the same filters and transformations that were applied in the original macro. For example, if the macro only shows items from a specific project, sorted by Assignee, that's exactly what you'll see on the Structure Board. To review or remove these transformations, click the Transformations button in the panel toolbar.