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

0 vote
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
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

2,805 views 26 10
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