Panel Macro

The Panel macro displays a block of text within a customizable panel, like this:

Handy hint: You can use panels within columns, in table cells and in the sections defined by page layouts.

Using the Panel macro

To add the Panel macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

Parameters

Parameters are options that you can set to control the content or format of the macro output. 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).

Parameter

Default

Description

Panel Title
(title

none

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

Border Style
(borderStyle

solid

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

Border Color
(borderColor

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

Border Pixel Width (Value Only)
(borderWidth

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

Background Color
(bgColor

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

Title Background Color
(titleBGColor

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

Title Text Color
(titleColor

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

Wiki markup example

This example 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
{panel}

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport