Common issues and how to fix them.You can also review our Release Notes to find out about other bugs or features in various versions of Theme Builder.
By far the most common issues (all covered by our installation guide):
If you're using Theme Builder 3.0 Beta 27 or above, you'll also need to accept the End User License Agreement (EULA) before you can fully use the plugin.
These issues can occur when first installing or upgrading from an earlier version of Theme Builder. You may also like to refer to the section on #General Issues.
This issue only affects Builder 1.x and 2.x.
The plugin repository was modified so that it keeps a count of the number of times a plugin is installed - this modification broke the ability for the repository to install password protected plugins.
You'll need to manually download the plugin (URL and login details are in the email you received when you purchased Builder) and install it using either the Plugin Manager or the "Upload" tab in the Plugin Repository.
If uploading via the plugin manager, remember to uninstall the old version of the plugin first (the Plugin Repository "Upload" tab will do this automatically).
This issue does not affect Builder 3.0 and above.
You will need to import the 2.x theme settings using the following procedure:
- Go in to the Confluence "Administration" console
- Click the "Builder Administration" (or "Theme Administration" depending on the version of Builder) link
- Use the "Import all layouts" option on the Backup Tab
Once the old theme configurations have been imported (and converted to layouts) you can then apply them to spaces using the Manage Spaces Tab.
The following issues are related to various theme settings.
In Theme Builder 3.0 and above, a new feature adds pop-up access key hints at the top of the page. In normal use, these hints will not been seen however there are a couple of things that cause them to be displayed...
If you have disabled CSS or are using a browser which does not support CSS, the links will always be shown - this is expected behaviour and is required for compliance with accessibility laws throughout Europe and other parts of the world.
If you have disabled the "Builder Default CSS" option in the CSS Tab, you will need to add some "Custom CSS" to make the hints work properly as follows:
It's a known bug in Theme Builder 2.x - choose the option twice and the upload panel will appear.
This bug does not affect Builder 3.0 or above.
These issues are not directly related to the Theme Builder plugin, but are often associated with it.
Install the "Content Formatting Macros" plugin which contains macros required for the layout of the title panel.
It's likely that the "table" macro within Atlassian's "Compatibility Macros" plugin is enabled.
Disable the "table" macro in the "Compatibility Macros" plugin (or the entire plugin) using the Plugin Manager (or plugin repository).
Note: We plan to add a table2 alias to our table macro in the Content Formatting Macros plugin at a later date - this would allow you to run both plugins alongside each other.
Install the the "Page Information Tools" plugin version that's applicable to your version of Confluence.
Many Confluence macros are developed for use only on wiki pages and blog posts. However, Theme Builder allows you to use macros within the theme layout in which case they get rendered throughout the entire space causing errors to appear when those macros find themselves in unexpected places.
To solve this issue, use the builder-show macro, for example:
That will only show the macros when you are viewing a wiki page or blog post, and hide them everywhere else preventing the errors from appearing.
This is caused by the table macro in the "Compatibility Macros" plugin (or "incompatibility macros" as we fondly refer to it here at Adaptavist!). Disable the table macro in that plugin (using plugin manager or plugin repository client) or preferably the entire macro!
This issue only applies to Theme Builder 1.x and 2.x. You will need to upgrade to Theme Builder 3.0 or above for compatibility with clustered environments.
Note: You will also need the correct form of Theme Builder license, i.e. one license per node.
Please upgrade to Confluence 2.5.x or above and Builder 2.0.9 or above to resolve this issue.
This issue affects Theme Builder 3.0 and above which uses the "table" macro from the "Content Formatting" plugin to structure the dashboard.
The problem is caused by a conflicting "table" macro in one of the bundled plugins, "Compatibility Macros".
Disable the "Compatibility Macros" plugin using Plugin Manager.
This issue affects Confluence 2.7.1 and above. To solve, add the following to the custom CSS for your layout
The following issues have been reported when upgrading Confluence.
Atlassian changed the way the site administration privileges work in Confluence 2.7 - if you're using an earlier version of Theme Builder, you'll need to upgrade to Theme Builder 3.0 Beta 23 or later for compatibility with Confluence 2.7.
Atlassian changed the structure of tabs in Confluence 2.6.0 and above - if you're still using Builder 2.x then there are two options to solve this:
The easiest option is to upgrade to Builder 3.0 or above which has more dynamic support for changes to Confluence and it's style sheets.
Note: If your link properties window is distorted, you should first upgrade to Confluence 2.6.2 which fixes several bugs found in Confluence 2.6.0 and 2.6.1.
If you want to continue using Builder 2.0.x, you can add the following CSS to the bottom of the "Custom CSS" setting in Theme Configuration:
This issue only applies to Theme Builder 2.x and earlier.
If you've upgraded from Confluence 2.2.x (or earlier) to 2.3.x (or later) it's likely that the
/configfolder wasn't copied over in the upgrade process. Simply copy the
/configfolder from the old install to the new install and all the theme settings should come back.
Note: We have also had reports of this issue when upgrading from Confluence 2.3.x (or above) to a later version. Please check that the
/configfolder has been copied across during the upgrade - if not, manually copy it to the new Confluence install.
This issue will not affect Builder version 3 or above because settings are be stored in the database rather than XML files in the
If you've just upgraded to Confluence 2.6 or above you'll need to upgrade the "Page Information Tools" plugin to version 1.2.6 or above.
Disable the "table" macro in Atlassian's "Compatibility Macros" (or the whole plugin if you don't need it.
See "The title panel looks messy" topic at the top of this page for more information and additional issues that may cause this effect.
Upgrade to Theme Builder 2.0.8 or later to fix this issue.
Upgrade to Builder 2.0.8 or above to fix this issue.