Builder 2.x introduced a visual layout editor and a vast array of new customisation options. For more information on what's new in Builder 2 (hey, that rhymed!) check out Migrating from 1.x.
Some Theme Builder 2 releases are tailored to specific versions of Confluence:
Builder 2.x is not compatible with Confluence 2.7 or above - you will require Theme Builder 3.x.
An upgrade from Builder 1.x to 2.x will lose some settings due to significant architectural changes. Clients upgrading from 1.x to 2.x should contact Adaptavist Support prior to performing the upgrade or alternatively start with a fresh theme layout. See Migrating from 1.x.
Please note that Builder 2.0.x does not support clustered Confluence environments.
If you are require clustering, please use Builder 3.x or above.
Builder 2.0.x and above require that you install two additional open source plugins (developed by Adaptavist) for correct operation:
These plugins are maintained on an ongoing basis by Adaptavist as they are required for the Theme Builder plugin.
Theme Builder 2.x customises global and space level pages separately. You can copy the global customisations to spaces by entering the global theme configuration screen and choosing "File > Download Settings" then uploading the settings file to any number of spaces by using the "File > Upload Settings..." option.
It's a known bug in Theme Builder 2.x - choose the option twice and the upload panel will appear.
It's under the Macros section in our user guides.
You can also find notation and examples in the "Full Notation Guide" when editing pages using the "Wiki Markup" editor.
The Confluence upgrade process doesn't import the Theme Builder configuration files. To resolve this issue, manually copy the "/config" folder from your backup of the previous installation to the new installation and everything should return to normal. In very rare cases you might need to restart Confluence for the changes to take effect.