Opened 5 years ago

Closed 10 days ago

#4117 closed defect (bug) (fixed)

Proposal to change the headings hierarchy in the Support section

Reported by: afercia's profile afercia Owned by: adamwood's profile adamwood
Milestone: Priority: normal
Component: Support Forums Keywords: headings-hierarchy


Splitting this out from #4110.

The headings hierarchy in the Support section has room for improvements for better SEO and accessibility:

As mentioned in #4112 the logo shouldn't be a h1. The main topic in this page is "WordPress Support" and that should be the only h1 in the page.

The headings hierarchy is incorrect: all the other heading should be bumped up from h3 to h2.

Categories main pages:
they look OK with the exception the logo shouldn't be a h1 see for example

Article pages:
In the article pages, for example

  • the logo shouldn't be a h1
  • in the left sidebar, the "Categories" h2 comes before the main topic h1, which is unexpected
  • the hierarchy of the headings in the content is correct but there's a problem: the "hash link" to get the in-page link repeats the visible text. This way, all the headings have duplicated content.

In the example page, any software including search engines crawlers and assistive technologies perceive the following headings content:

  • Introduction Introduction
  • Plugin Repositories Plugin Repositories
  • Default Plugins Default Plugins
  • Plugin Development Plugin Development


  • the headings shouldn't contain extraneous content: the "hash link" should be moved out from the headings
  • ideally, it should have a meaningful link text, e.g.: "link to the section Introduction", "link to the section Plugin Repositories", etc.

Please consider the Support section has a huge amount of sub-section, pages, and content. Going through all of them is out of the scope of this ticket. However, these are general guidelines that should be applied everywhere.

Attachments (1)

support_homepage_fix.diff (8.7 KB) - added by dufresnesteven 4 years ago.
Updates heading structure for wporg-support. Does not address issues in handbook.

Download all attachments as: .zip

Change History (8)

#1 @afercia
5 years ago

Additionally, in the Support Forums, the headings hierarchy in the sidebar needs improvements. For example in this page Forum threads about Bluehost » which is also linked from the "Hosting" section, the headings "Views" and "Feeds" in the sidebar are h4 headings:

They should be changed to h2.

As said, I'm sorry I can't really catch all the cases: there are simply too many pages and different views so please consider these as general guidelines that should be applied across all the network. See also the tracking ticket #4110 for a a chrome extension that can be used as a quick tool to check the headings structure.

#2 @dd32
5 years ago

  • Component changed from General to Support Forums

4 years ago

Updates heading structure for wporg-support. Does not address issues in handbook.

This ticket was mentioned in Slack in #forums by vladytimy. View the logs.

13 months ago

#4 @mrfoxtalbot
13 months ago

Since the forums page is being redesigned, I am going to cross link to #4007 to ensure this ticket is taken into account.

#5 @adamwood
12 days ago

  • Owner set to adamwood
  • Status changed from new to assigned

New [Forums landing page] has valid headings. Other pages are in progress.

#6 @adamwood
12 days ago

Sidebar hierarchy updated in, which fixes the single topic view. However many views like have no h1, so remain broken.

#7 @adamwood
10 days ago

  • Resolution set to fixed
  • Status changed from assigned to closed

In 13506:

wporg-support-2024: Fix heading hierarchy

Adds h1 headings to many pages and adjusts styles

Fixes #4117

Note: See TracTickets for help on using tickets.