Create
cancel
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 atlassian-bundled-plugins.zip 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 atlassian-bundled-plugins.zip 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 atlassian-bundled-plugins.zip, 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)

Excerpt:

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
TAGS
Community showcase
Published in Jira

Admins, notify your Jira instance of system-wide changes with the new admin announcement banner

Hi All! We’re excited to share the launch of an announcement banner that lets Jira site administrators communicate directly to their users across their  Jira Cloud instance.  ...

566 views 15 18
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