Daily Accessibility ReviewMultiple H1 Elements Per Page Violate Heading Structure

[github-actions[bot]]

Problem Description

Multiple pages in the Rancher Dashboard render more than one <h1> element, violating the semantic heading structure expected by screen readers and assistive technologies.

Affected pages and components:

• Home page (/dashboard/home): Two <h1> elements — "Welcome to Rancher" (banner graphic) and "Clusters" (content area heading).
• Cluster Dashboard (/dashboard/c/local/explorer): Multiple <h1> elements — "Cluster Dashboard" (page title) plus numeric stat values such as "546", "1", "10" from CountGauge, ResourceSummary, and CountBox components.

WCAG 2.2 Violations

• **[1.3.1 Info and Relationships (Level A)]((www.w3.org/redacted) Information, structure, and relationships conveyed through presentation must be available in text. Multiple <h1> elements give screen reader users an incorrect picture of page structure.
• **[2.4.6 Headings and Labels (Level AA)]((www.w3.org/redacted) Headings and labels describe topic or purpose. Numeric statistics ("546", "1", "10") should not be marked up as headings since they do not describe a topic or section.

Relevant Code

shell/components/CountGauge.vue (line 102):

<div class="data">
  <h1>{{ useful }}</h1>   <!-- numeric count, not a page heading -->
  <label>{{ name }}</label>
</div>

shell/components/ResourceSummary.vue (line 120–123):

<h1>{{ resourceCounts.total }}</h1>
<h3>
  {{ name }}
</h3>

shell/components/CountBox.vue (line 70):

<h1>{{ count }}</h1>
<label>{{ name }}</label>

shell/pages/home.vue:

<h1 class="mb-0"><!-- "Welcome to Rancher" --></h1>
...
<h1 class="mb-0"><!-- "Clusters" --></h1>

Recommended Fix

Replace <h1> with <span> (or a non-heading element) in stat/count components (CountGauge, ResourceSummary, CountBox) and apply equivalent CSS styling. The page-level heading ("Cluster Dashboard", "Welcome to Rancher") should be the sole <h1> per page. Section headings like "Clusters" should use <h2> or lower.

Generated by Daily Accessibility Review · ● 1.8M · ◷

• expires on May 28, 2026, 8:31 AM UTC