RuntimeException Error rendering template for decorator root in a Page

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs 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

Summary

Symptoms

A stack trace error appears when visiting one or more pages, sometimes after an upgrade. The page may have been working fine previously. Not all pages are affected. The atlassian-confluence.log file contains a stack trace similar to:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 2010-04-08 11:35:24,597 ERROR [http-10.28.1.96-80-12] [atlassian.confluence.servlet.ConfluenceServletDispatcher] sendError Could not execute action -- referer: http://confluenceURL/dashboard.action | url: /display/Spacekey/Home | userName: admin java.lang.RuntimeException: Error rendering template for decorator root at com.atlassian.confluence.setup.velocity.ApplyDecoratorDirective.render(ApplyDecoratorDirective.java:211) at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:175) at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:336) at org.apache.velocity.Template.merge(Template.java:328) ... Caused by: java.lang.RuntimeException: Error rendering template for decorator page at com.atlassian.confluence.setup.velocity.ApplyDecoratorDirective.render(ApplyDecoratorDirective.java:211) at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:175) ... Caused by: org.apache.velocity.exception.MethodInvocationException: Invocation of method 'getDisplayableLabel' in class com.atlassian.confluence.plugin.descriptor.web.model.ConfluenceWebLabel threw exception com.atlassian.core.exception.InfrastructureException: Error occurred rendering template content at template/includes/menu-macros.vm[line 132, column 36] at org.apache.velocity.runtime.parser.node.ASTMethod.handleInvocationException(ASTMethod.java:337) ... Caused by: com.atlassian.core.exception.InfrastructureException: Error occurred rendering template content at com.atlassian.confluence.util.velocity.VelocityUtils.getRenderedContent(VelocityUtils.java:123) at com.atlassian.confluence.util.velocity.VelocityUtils.getRenderedContent(VelocityUtils.java:106) at com.atlassian.confluence.plugin.descriptor.web.ConfluenceWebFragmentHelper.renderVelocityFragment(ConfluenceWebFragmentHelper.java:57) at com.atlassian.plugin.web.model.DefaultWebLabel.getDisplayableLabel(DefaultWebLabel.java:71) at com.atlassian.confluence.plugin.descriptor.web.model.ConfluenceWebLabel.getDisplayableLabel(ConfluenceWebLabel.java:35) ... Caused by: org.apache.velocity.exception.MethodInvocationException: Invocation of method 'getLatestVersionsOfAttachments' in class com.atlassian.confluence.pages.Page$$EnhancerByCGLIB$$6a222880 threw exception net.sf.hibernate.LazyInitializationException: Failed to lazily initialize a collection at getRenderedContent[line 1, column 15] at org.apache.velocity.runtime.parser.node.ASTMethod.handleInvocationException(ASTMethod.java:337) ... Caused by: net.sf.hibernate.LazyInitializationException: Failed to lazily initialize a collection at net.sf.hibernate.collection.PersistentCollection.initialize(PersistentCollection.java:201) at net.sf.hibernate.collection.PersistentCollection.read(PersistentCollection.java:71) ... Caused by: net.sf.hibernate.HibernateException: collection was evicted at net.sf.hibernate.impl.SessionImpl.initializeCollection(SessionImpl.java:3303) at net.sf.hibernate.collection.PersistentCollection.initialize(PersistentCollection.java:195) ... 282 more

Diagnosis

Run encoding test to see if there's an encoding issue (Troubleshooting Character Encodings).

Cause

The above error is a symptom and usually displays after the root cause error, which will be printed out to the atlassian-confluence.log. Search for the root cause error that occurs before the first of the "Error rendering template for decorator root" error.

Occasionally the error can be thrown:

  1. When there is a compatibility issue with your custom layout.

  2. When there is corruption in the search index.

  3. When there is a StackOverFlow and the JVM crashes, due to a loop when using {excerpt} and {excerpt-include} macros

  4. When there is a viewfile macro linked to a corrupt document (ie xlsx, docx).

  5. Confluence is running on non UTF-8 encoding

Solution

Resolution

To resolve this problem,

  1. Try resetting the custom decorator from Administration >> Layouts or Browse >> Space Admin >> Layouts.

  2. If you can't get to either of those pages, you can completely remove all decorators as follows:

    1. Back up your database using database-native tools.

    2. Shut Down Confluence

    3. Save a copy of your customizations by saving the output of this query:

      1 select * from decorator;
    4. Delete your customizations:

      1 delete from decorator;
    5. Start Confluence

  3. Try rebuilding the Confluence index from scratch.

  4. Reference CONFSERVER-15247 - Java quits or exits - Seg Fault due to recursive ExcerptInclude Macro to get a better understanding of what is causing the crash. If you're using 3.1.2 (or onwards) version, update the Advanced Macro to version 1.6.9. If you're using a older version, please upgrade to a later version of Confluence.

  5. Page titles may be null. See 'java.lang.RuntimeException - Error rendering template for decorator root' when Accessing a Page Due to Null Page Titles.

  6. Follow the instructions for Cannot edit page: Editing or Deleting a Page That Won't Render.

  7. Fix the encoding in Confluence server. It has to be UTF-8.

Updated on April 16, 2025

Still need help?

The Atlassian Community is here for you.