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

How do you customise a bundled theme?

Michael S Atlassian Team Jun 08, 2011

Is it possible to modify the bundled themes stylesheets and/or layout? What's involved? What are the risks/considerations?

2 answers

1 accepted

Comments for this post are closed

Community moderators have prevented the ability to post new answers.

Post a new question

1 vote
Answer accepted

The documentation @Brendan Patterson mentions is good for customising the default theme, but if you want to customise one of the other themes, you'll have to modify that theme's JAR file.

Actually it's this somewhat buried comment that you need, to modify a bundled plugin. From Plugin loading strategies in Confluence:

Bundled plugins are included in a zip of jars called which is on the main Confluence classpath, in a resources directory - <tt><confluence-install>/confluence/WEB-INF/classes/com/atlassian/confluence/setup</tt>. At Confluence startup, they are extracted and copied into the $CONFLUENCE_HOME/bundled-plugins directory, from whence they are loaded. To remove a bundled plugin (you shouldn't normally have to do this), remove the plugin from the file and the bundled-plugins directory, otherwise Confluence will just put it back in place on the next startup.

So, if you want to modify something in a bundled theme that's not the default theme, you can extract the correct bundled theme from, rezip the folder, then restart Confluence.

Alternately, just unzip the jar file, change the plugin key, and leave the original as is. You can have both installed safely, although it obviously could get a bit confusing with two similar themes installed.

The Confluence docs cover this pretty well:
Modifying Look and Feel (for themes)


Here's how you can define a new look and feel for Confluence in your theme:

  1. Layout : Edit Confluence's layout by modifying the decorator files that are used to define it.
  2. Colour schemes : Configure a new colour scheme for your theme. Optional
  3. Stylesheet : Include a stylesheet to define your theme. Optional

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