Advanced Panelboxes for Confluence



Panel boxes are useful to structure text on a Confluence page and are very easy to use. Confluence Administrators can configure a set of Panelboxes in the app settings.

The user can simply pick a predefined box - no need to deal with macro parameters to match the cooperate design. These are Advanced Panelboxes, unlike the standard Confluence {panel} macro.

On Advanced Panelboxes


Working with Advanced Panelboxes has the following advantages over standard Confluence panels:

  • The Panelboxes' layout is defined in the Advanced Panelboxes' configuration.

  • Only Confluence administrators have access to the Advanced Panelboxes' configuration.

  • In order to style a Panelbox, an editor doesn't have to use any additional macro parameters.

  • More uniformity throughout the site: The editor just chooses from a set of predefined Panelboxes.

  • If the style of a Panelbox needs to be changed (for example, when the colour scheme of the cooperate design changes), those changes are made once in the app configuration. All the corresponding Panelboxes are changed immediately throughout the whole Confluence instance. No need to edit hundreds of pages!


Using the Panelbox Macro

  1. In the editor, type "{panelbox" and choose "Advanced Panelbox".

  2. In the overlay, choose a predefined Panelbox in the dropdown, for example "red".

  3. You may give the panel a title and decide on its alignment. You may also choose a title icon or insert an image URL.


  4. If you like the preview of the Panelbox, click "Insert".

  5. Back in the editor, fill the Panelbox with content.

  6. Publish/update the page when you are done.

  7. The Panelbox "red" is now part of your page.

Configuring Advanced Panelboxes

In the configuration of the Advanceded Panelboxes (in the Administration Console) you can configure the Panelboxes:

  1. In the app management section , select "Advanced Panelboxes for Confluence" and click on "Configure":

  2. You will now see a list of your individual Panelboxes.



Configuring an existing Panelbox

  1. Click on the "Edit" link on the right side of the Panelbox you want to edit:

  2. Change any settings you like, then click the "Save" button.

  3. The new settings will now be applied to all Panelboxes with the name "blue". No need to edit dozens of pages once a setting changes!



Adding a new Panelbox

  1. To create a new Panelbox, click on "+ Add Panelbox".

  2. Scroll down the list until the last entry. This is your new Panelbox. Edit the Panelbox, assign it a new name and new properties.

  3. When you are happy with the preview, click the "Save" button.

  4. Your new Panelbox may now be used anywhere on your Confluence.


Parameters of the Panelbox Macro





This is a required field






This is a required field




The name of your configured panelbox



The title to display in header (leave blank for no header)


Apply panel title if title is left empty



Title alignment



center, left, right

Title icon

The title icon to display in header.


Title image URL

The URL of title image.


Panelboxlist Macro

This macro can be used to create a list of all the available Panelboxes. This is very useful for normal Confluence users without access to the Advanced Panelboxes app configuration.

Normal mode


Mobile mode