Status Macro

Add the Status macro to a page to highlight the status of a project, task, or item with a colored lozenge (rounded box).

This macro is great for indicating: 

  • items that are problematic or removed

  • a successful project

  • tasks that are in progress.

You can choose a solid or light background color for the lozenge and the text that appears inside the lozenge. The macro displays its current status directly in the editor. 

On this page:

Screenshot: Status macros in a table highlighting important tasks, actions, and items. 

tip/resting Created with Sketch.

See the Status macro put to excellent use in How to build a release planning page in Confluence.

Using the Status macro

To add the Status macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose Status from the Confluence content category.
  3. Enter a status and choose a color.
  4. Choose Insert

You can then publish your page to see the macro in action. 

Screenshot: Selecting lozenge colour in the Status macro.

Change the macro parameters

Macro parameters are used to change the behaviour of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and choose Edit.
  2. Update the parameters as required then choose Insert.

Here's a list of the parameters available in this macro. 






The color of the lozenge. The following colors are available: Grey , Red, Yellow, Green and Blue.


The color that you select.

The text that will appear inside the lozenge. If you do not specify any text, the title will be the color of the lozenge, that is 'Grey', 'Red', 'Yellow', 'Green' or 'Blue'.

Use lighter lozenge color


The lozenge background color and text color. The default lozenge style is a solid background color with white text. Select this parameter to use a lighter lozenge background color with colored text.

Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

Other ways to add this macro

Add this macro as you type

Type followed by the start of the macro name, to see a list of macros. 

Add this macro using wiki markup

This is useful when you want to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: status

Macro body: None.

{status:colour=Green|title=On track|subtle=true}
tip/resting Created with Sketch.

Do more with Confluence

For more customizable status macros check out these apps on the Atlassian Marketplace:  

Last modified on Nov 24, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.