Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,360,196
Community Members
 
Community Events
168
Community Groups

Which H1 Heading is recognized by a Screen Reader on a Confluence Page with a Table of Contents?

Lea Kivi I'm New Here Aug 31, 2022

Hello.

I am trying to create a Confluence page that can be used by a screen reader. The page includes a Table of Contents macro.

My understanding is that screen reader-accessible pages should only have one H1 heading on them (I'm not concerned about SEO optimization at this point - just accessibility).

When I 'View Page Source', I see that the logo is wrapped in an H1 heading, as is the page title.

However, the Table of Contents macro does not present either of those H1s. I need to create an H1 heading manually for it to appear in the page's Table of Contents.

Does anyone know whether a screen reader will successfully 'see' the H1 heading I created manually to appear in the Table of Contents, or would the H1 headings associated with the logo and / or page title interfere with such recognition?

Thanks.

1 answer

Hi @Lea Kivi 

I am from Addteq and we have made Unstoppable to increase the accessibility of Confluence

  • I see that the logo is wrapped in an H1 heading, as is the page title.
    • This should not be the case. H1 comes in separately as a heading
  • However, the Table of Contents macro does not present either of those H1s.
    • Again Table of contents should create the H1 headers as is. The screenreader should also be able to read the content. 
  • My understanding is that screen reader-accessible pages should only have one H1 heading on them

If you are still facing issues you can reach out to us here

Lea Kivi I'm New Here Sep 01, 2022

Thank you for your offer of assistance.

Suggest an answer

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

Watch 4 Confluence apps compete for Best App Demo in September's Appy Hours

Calling all collaborators! Appy Hours on the Atlassian Community is a monthly event where 4 Partner and app vendor presenters go head-to-head with 5-minute demos for the title of Best App Demo. I...

524 views 0 12
Read article

Atlassian Community Events