Panel Macro

This macro is available in Confluence Server and Data Center. Learn about the macros available in Confluence Cloud.

Add the Panel macro to a page to format your text in a customizable coloured panel. It's similar to the Info, Tip, Note, and Warning Macros except you have complete control over the border, background, title and text colours. 

This is great for adding some visual interest to your pages. You can use panels in table cells and in page layouts, as in the example below.

On this page:

Screenshot: page with a purple Panel macro containing a list of useful links. 

Add this macro to your page

To add the Panel Map macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose Panel from the Formatting category.
  3. Enter any parameters. Leave blank for a simple white panel with a grey border.
  4. Choose Insert

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

Screenshot: specifying a title, border, and background colour in the Panel 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. 




Panel Title


The title of the panel. If specified, this title will be displayed in its own title row.

Border Style


The style of the panel's border. Accepted values are solid, dashed and other valid CSS border styles.

Border Color

The color of the panel's border. Colors can be specified as HTML color names or hexadecimal codes.

Border Pixel Width (Value Only)

The width of the panel's border (in pixels).

Background Color

The background color of the panel. Colors can be specified as HTML color names or hexadecimal codes.

Title Background Color

The background color of the title row of the panel. Colors can be specified as HTML color names or hexadecimal codes.

Title Text Color

The color of the text in the title row of the panel. Colors can be specified as HTML color names or hexadecimal codes.

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).

Available colors

You can enter the HTML or X11 name for a color such as Fuchsia, Teal, or MediumOrchid, or you can enter hexadecimal values such as #FF00FF#008080, and #BA55D3.  You will need to include the # symbol when entering a hexadecimal value.  See Web colors for general information. 

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: panel

Macro body: Accepts rich text.

{panel:title=My title|borderStyle=dashed|borderColor=blue|titleBGColor=#00a400|titleColor=white|bgColor=#72bc72}
A formatted panel
tip/resting Created with Sketch.

Do more in Confluence

To further customize panels, check out these apps on the Atlassian Marketplace

  • Panelbox: Create a set of designed panelboxes to display identical topics in the same style, keeping your pages clear and easy to read
  • Panels: Make your intranet more interactive with a customizable panels
Last modified on May 25, 2023

Was this helpful?

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