Panelboxes are useful to structure text on a wiki-page and are very easy to use. Confluence Administrators configure a set of panelboxes in the plugin configuration. The user then just picks a pre-defined box without having to deal with half a dozen macro parameters and their values in order to match the cooperate design, like it is the case with the Confluence {panel} macro.

Panelbox Macro

The panelbox macro has the following advantages over normal Confluence panels:

  • The layout of the panelboxes are defined in the plugin configuration
  • Only Confluence administrators have access to the panelbox configuration
  • In order to style a panelbox the author doesn't have to use any additional macro parameters
  • More uniformity throughout the site. The user just chooses from a set of pre-defined panelboxes
  • If a style of panelbox needs to be changed, for example when the colour scheme of the cooperate design changes, those changes are made once in the plugin configuration. All the corresponding panelboxes are changed immediately throughout the whole Confluence instance without having to edit hundreds of pages.
  • The header of a panelbox can not only contain normal text but also wiki-syntax.




NameDescriptionTypeThis is a required fieldDefaultValues
The name of your configured panelboxenum
The title to display in header (leave blank for no header)string


{panelbox:name=blue|title=Please read the documentation}
Wiki syntax in panelbox titles will be rendered by Confluence. Give it a try!



Panelboxlist Macro

This macro can be used to create a list of all the available panelboxes. This is very useful for normal Confluence users when they have no access to the panelbox plugin configuration.



This macro has no parameters




Normal mode


Mobile mode


In the configuration of the Panelbox plugin, which is in the Administration Console, you can configure the panelboxes:

  1. In the add-on management section in the administration console of Confluence, select the Panelbox plugin and click on "Configure":
  2. Configure the panelboxes:



Related articles



Comments  (0)

Attachments  (9)

Add Attachment
  File Modified
PNG File panelbox-screenshot-3.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-logo.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-screenshot-2.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-screenshot-1.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-plugin-config-1.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-plugin-config-2.png 03. Mar. 2014 by Remo Siegwart
PNG File image2015-7-31 10:6:45.png 31. Jul. 2015 by Oliver Sträßer
PNG File image2015-7-31 10:8:16.png 31. Jul. 2015 by Oliver Sträßer
PNG File image2015-7-31 10:9:7.png 31. Jul. 2015 by Oliver Sträßer