This documentation has moved. For the most recent documentation, check out Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata

Frequently Asked Questions on ThemeBuilder

If you need more explanation or have any other questions then please contact us.


 Can we still use Wiki Markup in ThemeBuilder?

Yes – You can still use wiki markup in ThemeBuilder. There’s an option in the panel editor to choose between storage format, wiki markup or plain html for each panel, and you can use the new macro insert and editor buttons in wiki markup mode as well.

You just need to remember that wiki markup in a skin has to be processed by Confluence so it can be displayed as html, and that makes it less efficient than rendering storage format. That extra processing time may be measured in milliseconds, but at the Enterprise level this can be a crucial detail, so we recommended using storage format as soon as you’re comfortable with it.

 Can we use existing Theme Builder layouts in the new version?

No – sorry, we tried really hard to make this happen and just couldn’t. Mainly because there isn’t an efficient way to allow full backwards compatibility with the new skin format. The power and flexibility in skins is such an advancement on previous ThemeBuilder versions that it would have impacted the product to allow old layouts to be imported. But we know this was going to be an issue with our loyal ThemeBuilder users so we created the new free Layout Exporter plugin to help you migrate your layout to ThemeBuilder.

With the layout exporter you’ll be able to export a theme builder layout into the new skin format, but there may still be some manual conversion needed if, for example, you have a theme that uses complex menu code or older deprecated macros.

The thing to bear in mind is that the Confluence 5 user interface has evolved to a point where these older designs really need to be reviewed and updated, to make sure you’re taking advantage of all the great new functionality in Confluence and ThemeBuilder.

 Do we have to pay for the layout exporter?'

No - the Layout Exporter plugin is completely free and can be downloaded from the Migrating from Theme Builder 4 to ThemeBuilder 5 page.

 Where has the panel layout view gone?

The new code used in  ThemeBuilder to hold all the Confluence content together doesn’t have the same fixed table based framework that the previous  Theme Builder used to rely on for content layout.

The ROOT skin recreates the standard Confluence 5 look to give you a familiar starting point for a new design, but because the whole page is now based on html divs, and not tables, you’re free to pull apart and rebuild a confluence page in any shape you like when you customise a skin.

Because the panel divs are positioned on the page only when that page is finally displayed in the browser, we can’t show a panel view that resembles the finished page. So now ThemeBuilder presents all panels in a list – where you can edit names and descriptions that will help you relate those panels to the correct areas on the finished page. The bonus here is that you are no longer limited by a fixed number and positioning of content panels. You can have as many panels as you want in a skin, nest those panels, and position them where you want with CSS.

 Will there be a mobile responsive skin?
The great thing about new ThemeBuilder is the ability to take Confluence elements out of the standard theme and rebuild them inside your own custom HTML. So if you want a theme that meets mobile or responsive needs then you can build that into your skin exactly as you would with any other web template.

We will also be working on a mobile skin to be released as part of the new Themes For Confluence product.

 Can ThemeBuilder control the display of content so it can only be seen by certain groups?
Yes – One of the powerful features in ThemeBuilder is the ability to set conditional logic that controls the display of content under certain pre-set circumstances. This is known as flaglogic, and in previous versions was often used with the builder-show and builder-hide macros to wrap logic controlled content. ThemeBuilder 5 takes this logic a step further by adding the ability to detect and use flags into every ThemeBuilder macro, making conditional display a native part of every function in your skin.
 Will there be more support in the paid version?

Yes – For Licenses of 50 users or higher, the paid version of ThemeBuilder will include one year of helpdesk support, plus plugin maintenance and updates.

For Licenses of 10 and 15 users there will be community support forums, plus plugin maintenance and updates.

 Can the images in the Carousel macro have alt tags added for accessibility?

As the Carousel macro is a decorative item the images are added to the page as CSS backgrounds and therefore should not need alt tags. We have added an accessibility review of the Carousel into the ThemeBuilder roadmap so please contact us if this is an urgent issue for you.

 Can I use the ThemeBuilder macros without creating a custom ‘skin’?

Yes – if you have ThemeBuilder installed and a current license, you can use any of the included macros like the Carousel in any of your confluence pages.

 Where can I find Theme Builder 4 documentation?

Theme Builder 4 Documentation for Confluence 4 and earlier.

 How to Turn off Google Analytics

Please see our documentation for information on turning off google analytics : Turning off Google Analytics


For ThemeBuilder support, if you cannot find the answer in our documentation, please read the Adaptavist Product and Add-ons Support SLA.


  • No labels