How to resolve label length restrictions

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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


The following error appears when you try to add many labels to a page and the labels are very long (label names must be less than 255 characters).

java.lang.IllegalArgumentException: Request header is too large


The query string is so long it hits the Tomcat header size limit.


Option 1. Reduce the length of the label names (suggested option)

Option 2. Edit the server.xml property as follows:

    • Go to <confluence-installation>\conf\server.xml
    • In the <Connector/> tag, add the property maxHttpHeaderSize. This property defaults to 8192, but you can increase it to suit your needs. Setting it to 40960 should accommodate your absolute maximum use case.

DescriptionIf labels are extremely long and there are a lot of them, the macro may hit the Tomcat header size limit. Adjust the maxHttpHeaderSize property of the tomcat server.
Last modified on Sep 10, 2020

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.