Missing buttons or the entire top bar with "$soyTemplateRendererHelper.getRenderedTemplateHtml" error message
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Problem
The top Confluence header bar is missing or some of the buttons can't be seen. Instead, appears an error message:
$soyTemplateRendererHelper.getRenderedTemplateHtml("com.atlassian.auiplugin:aui-experimental-soy-templates", "aui.page.header.soy", $templateParameters)
If you look closely, there's an error message with black font in the blue top bar.
Diagnosis
You may have undergone the following prior to this issue:
- Confluence upgrade
- Server system update
- Updating plugins which can trigger this bug: CONFSERVER-22390 - Plugin's velocity module is disabled by Confluence
Cause
Some system plugins or modules related to the navbar are disabled.
Resolution 1 - REST API
To resolve this without downtime, follow the REST API workaround described on the bug: CONFSERVER-22390 - Plugin's velocity module is disabled by Confluence
Resolution 2 - Database (requires downtime)
Check if there's any system plugin that's disabled:
Check the state of your plugins in the database side:
select bandanavalue from bandana where bandanakey = 'plugin.manager.state.Map'
Check if one or all of the following lines exists:
<entry> <string>com.atlassian.confluence.extra.officeconnector:velocity.helper</string> <boolean>false</boolean> </entry> <entry> <string>com.atlassian.confluence.plugins.confluence-lookandfeel:siteLogoHelperContext</string> <boolean>false</boolean> </entry> <entry> <string>com.atlassian.confluence.plugins.soy:soyTemplateRendererHelperContext</string> <boolean>false</boolean> </entry>
This indicates that the entries above are disabled. The three entries refer to plugin modules. You may see all or just some of them disabled.
Use the guide from the documentation below to return the plugin back to enabled: