It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Too many h1 tags on published spaces Edited


We start publishing our documents in confluence. When looking at the code, I've seen that confluence uses <h1> for the title, but also for all heading 1s. 

I think it's still valid that a website should only use one or a few h1 tags for search optimisation. 

It's not much a problem on large sites, but a small site with 4 headers has five <h1> tags on one single page with no subheaders.

Is there a way to fix that and map "Heading 1" on the <h2> tag?

Thank you for your thoughts!

2 answers

1 vote
Bill Bailey Community Leader Nov 06, 2018

I think that the "only one h1 heading on page" for SEO is bogus, or rather leftover from earlier search algorithms -- a holdover from years ago. Google can find content wherever it is. Headings help, but more to the readers to understand the flow of content.

Take a look at this article for some background how-important-is-h1-tag-for-seo:

If you already have good headings, wrapping them in H1 has some effect, but it’s small enough that “if it takes longer than an hour to implement H1 Tags on all pages and they already have some large descriptive text on the page then it is probably not worth the time required.”

What I think is often missed in SEO is that it is the value of the content that matters, and the number of other sites linking to your content to raise its value., not "did I have x number of keywords in my H1".

Hello Bill, 

The page you quote says: 

wrapping them in H1 has some effect


Also be careful to ensure that the H1 reinforces the point of the page, and that there is only one H1.

So why waste the potential of hundreds of sites with valuable content.

Bill Bailey Community Leader Nov 08, 2018

The funny thing about the article is it gives lots of evidence that it doesn't matter how many you have, just that the first one should be relevant to the content. But later, she reverts to a long-held belief that you should only have one. ;-)

This "rule" came from a time before search (and pages) were far less sophisticated. But because Google doesn't disclose their algorithms, people have adhered to old rules of thumb without really knowing it is works. Sort of like throwing salt over your shoulder for good luck: won't hurt, but probably won't help either - just makes you feel like you are doing something.

Hi @Manuel Merki are you working with any automation? If not - you can probably just hide Heading 1 in the editor toolbar so that this is the first option to choose.

Just an idea!

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Introducing Confluence Cloud and Jira Software Cloud Premium

Wherever you are in your team’s journey , our goal is to support your big ambitions. We’re a cloud-first company with the mission of unleashing the potential of every team, and to address the range ...

616 views 4 17
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you