Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Deprecation of the Panel macro

I was hoping to use the panel macro to provide different background colors to sections of my page.  I see it was deprecated in favor of the info panel. I am curious as to why, but what I am really asking is


How can I provide background colors to 'sections' of my page without hardcoded icons and default expectations.  For example, use orange without it being a warning?

1 answer

0 votes
Diego Atlassian Team Apr 14, 2020

Hello there!

Thanks for reaching out here in the Community, @edward.thompson . You can check more about why macros have been deprecated recently. Most of them have to do with performance or making the editor simpler. You can check more details here:


I can see that the new Info Panels bring a different message each. And also how confusing it can be for user who see one them out of context, used simply for coloring.


With this in mind, I can offer you two ways out of this. The first one involves the usage of our Legacy Editor. All customers should have access to it still. If you do not, you can request it, as specified here:

While using the Legacy Editor we are still able to use the Panel Macro. Even though the Macro documentation tells us that it is going to be deprecated:

Screen Shot 2020-04-14 at 17.42.02.png


The second option requires us to use Tables and cell coloring. In the new editor we still have the possibility of adding colors to a cell background. Under normal conditions, you should be able to create a visual pretty similar to what could be achieve with the panel macro:

Screen Shot 2020-04-14 at 17.21.58.png


Mimicking a panel:

Screen Shot 2020-04-14 at 17.46.37.png


I would say that the second option is easy to use and should yield pretty satisfactory results if the objective is to mimic a Panel Macro!



I hope this helps you out! Looking forward to your reply.

I have been using JIRA / Confluence / Bitbucket for years and I love these tools.  We've recently converted to Cloud, and unfortunately it appears that Confluence has taken some big steps backward in functionality. 

Like OP we also used the panel macros for formatting and to bring clarity to the docs. 

They weren't simply used for "coloring".  Warnings (yellow) would be used to highlight an important info, Error (red) would be used to highlight a dangerous point.  Green/Answer, etc.  Very common color associations. 

It also provides visual breaks between sections that are not as easy to see when the background is all white.

I am also very frustrated by the removal of the ability to add a panel macro inside another panel.  Having a warning panel inside a info panel doesn't seem like that unusual of a situation. 

The suggestion to use the legacy editor is not a realistic suggestion.  There are warnings all over the confluence documentation that the legacy editor and its macros are being deprecated.  

Finally, being told to use tables to mimic the panel behavior is disappointing.  Very 1999.  

It would be very useful if a generic panel macro was available, giving control of the background color, icon, display of the icon, etc.  

Like MA likes this
Matt Corr I'm New Here Sep 08, 2021

Using coloured tables to mimic Panels inside an area of the document with a section does not work.

I think all they need is just the option for a customisable panel. Have the new info, warn, tip, note, error ones that are currently utilised. But give us the option to create just a box with a selectable colour.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence Cloud

🏠 Say hello to the new Confluence Home!

Hi Atlassian Community, My name is DJ Chung, and I’m a Product Manager on the Confluence Cloud team. Today, I’m excited to share a new and improved version of Home. The new Home helps you ...

39,016 views 28 126
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you