Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Theming for Confluence is now GA

Hello Community!

The Confluence Cloud team is thrilled to share that theming is now generally available (GA) for all customers, including those on release tracks. We have been working towards this milestone for several months and have been gradually rolling out access through an alpha and beta program. Thanks to all of your feedback, we are now ready to move Light theme, Dark theme, and the match browser setting into general availability!

dark mode demo smaller.gif

Try out themes in Confluence

If you haven’t had a chance to try our new themes, it’s easy to do: Click on your profile icon in the top-right corner, then select Theme from the dropdown and choose from one of four options:

  1. Light: Our new default theme, very similar to the classic Confluence colors but with higher contrast for better accessibility.

  2. Dark: Our new dark theme, which can reduce eyestrain and save battery power.

  3. Match browser: This setting will follow whatever theming you’ve picked in your browser.

  4. Original: The classic Confluence colors. We plan to remove this option in the near future once we are confident that the new light mode works well.

What has changed since alpha and beta

We initially trialed our new themes with a small group of users during our alpha. This allowed us to spot and address any glaring issues before rolling out access more broadly. We then invited all customers on continuous release tracks to try out themes during our open beta. During this time, we received a lot of feedback from the community to help us refine the experience further. Rest assured that we read every single piece of feedback and have tried our best to address these bugs and suggestions. There is always room for improvement but we are confident that themes are now stable and usable for all Confluence customers.

Over the last few months we’ve adjusted dozens of design tokens for better contrast, added theming support for additional macros, and made hundreds of icons and illustrations compatible with theming. Recently, we also solved the two most commonly reported bugs:

  1. Custom colors in the top navigation bar

Custom color schemes set by Confluence admins are now compatible with dark mode. Admins have the ability to set a custom color scheme for the top navigation. Because these custom colors take precedence over user-selected themes, some users were previously reporting that their navigation bar did not match the rest of their experience in dark mode. We’ve implemented a solution that adjusts these custom navigation background colors to something more appropriate in Dark theme but still keeps the essence of the admin-selected light color.

  1. Colors in the legacy editor

We also heard from many of you working in the legacy editor or on pages that have migrated from the legacy to the new cloud editor that text and table cell colors were hard to see in Dark theme. We’re happy to share that our color picker in the legacy editor is now compatible with all themes and we’re also offering support for colors on pages migrated from the legacy editor.

What's next?

While the majority of experiences are now supported by themes, we realize with a product as expansive and robust as Confluence there will be loose ends that still need tending. We will continue to polish the experience and we always welcome your feedback. In the near future, we plan to retire the original theme in favor of our new light theme, which provides higher contrast for better accessibility.

Thank you to all of you who have taken the time to share your feedback with us. Your insights are invaluable in making our products better for everyone! We also want to give a huge shoutout to our marketplace partners who have been working hard on adopting themes for their apps. Apps make our products more powerful and delightful and we love to see all of the progress in creating a more seamless Confluence experience for our users.


Aron Gombas _Midori_
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
October 13, 2023

@Laura Mehrkens Is there any statistics of what percentage of the end-users actually use theming?

(We are app developers. We support theming in our Jira Cloud apps, and although it wasn't gigantic, it was a significant effort to do it correctly. Before we do the same for our Confluence Cloud app, it would be interesting to see numbers that justify the investment.)

Like # people like this
Lance Robert October 16, 2023

Happy for dark mode. These "over 40" eyes thank you.

Like Alex White likes this
Laura Mehrkens
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
October 17, 2023

@Aron Gombas _Midori_ 99% of our users use theming. Currently, about 91% use light theme, 6% dark theme, 2% match browser and only 1% still uses the original theme which does not use tokens. Although the majority of users use light theme, we’ve seen a steady increase of dark theme usage since our beta launch and expect this to grow further. It’s also important to note that dark and light are the first themes we’ve released but we plan to introduce more in the future.

Like # people like this
Aron Gombas _Midori_
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
October 18, 2023

@Laura Mehrkens Thanks!

Are there any mock-ups or screenshots you can share about the further themes to come? 


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events