How to get rid of the h1 tag around the Confluence logo?

Hi all,

we use Confluence to host our official product documentation and recently a SEO agency analyzed our pages.
They pointed out that from a SEO optimization point of view <h1> tags should only be used once per page. What is really bad about Confluence is that the Confluence logo is wrapped in h1.

I tried to remove the tag (or more replace it by a p tag, or so)

  • by editing the site layouts via Confluence
  • by editing decorator files directly from the file system.

Unfortunately, I did not succeed. I found a setup.vmd that seems to contain this, but editing the file (and restarting Confluence) had no effect. The h1 tags are still in  place.

Does anybody have an idea how to change this?


1 answer

1 accepted

This widget could not be displayed.
David Simpson Community Champion Jul 13, 2017

Looking at this code in decorators/includes/common-header.vm:

<header id="header" role="banner">
$soyTemplateRendererHelper.getRenderedTemplateHtml("com.atlassian.auiplugin:aui-experimental-soy-templates", "", $templateParameters)
<br class="clear">

It looks like that is generated in a soy template in an add-on.

Have a look for an add-on with the following key:



Thanks, David. Unfortunately, I'm not an add-on programer, but perhaps some of my colleagues can have a look at this.

It wasn't that hard, finally and I could fix it myself.

I found /opt/atlassian/confluence/confluence/WEB-INF/atlassian-bundled-plugins/auiplugin-5.9.24.jar, that contains a soy template There, I replaced the <h1> tags in

<h1 id="logo" class="aui-header-logo{if $headerLogoImageUrl} aui-header-logo-custom{elseif $logo} aui-header-logo-{$logo}{/if}">
                <a href="{($headerLink ? $headerLink : '/')}">
                    {if $headerLogoImageUrl}
                        <img src="{$headerLogoImageUrl}" alt="{$headerLogoText}" />
                        <span class="aui-header-logo-device">{($headerLogoText? $headerLogoText : '')}</span>
                    {if $headerText}<span class="aui-header-logo-text">{$headerText}</span>{/if}

by <p> tags and restarted Confluence.


Thanks, David, for hinting at this add-on.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Sep 17, 2018 in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

540 views 7 6
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you