Link text is descriptive and meaningful when read in isolation; no "click here" links
Why it matters
Screen reader users frequently navigate pages by cycling through links alone, hearing each link text in isolation without surrounding paragraph context. When links read "Click here", "Read more", or "Download" repeatedly, users cannot distinguish between them or understand where each leads. WCAG 2.2 SC 2.4.4 (Level A) requires link purpose to be determinable from the link text or its programmatic context; SC 2.4.9 (Level AA) tightens this to link text alone. Section 508 2018 Refresh 502.3.7 requires textual information to be available to AT. Generic link text also harms SEO, compounding both accessibility and discovery failures.
Severity rationale
Medium because non-descriptive link text impairs screen reader navigation and SEO but does not prevent users from accessing the linked content after identifying it through surrounding context.
Remediation
Replace every instance of generic link text with text that describes the destination or action. In blog listing components and card components, update the link text directly:
{/* Before */}
<a href={post.slug}>Read more</a>
{/* After */}
<a href={post.slug}>Read more about {post.title}</a>
For icon-only links, add aria-label:
<a href="/contact" aria-label="Contact support">
<EnvelopeIcon aria-hidden="true" />
</a>
For PDF downloads and external files, describe the destination and file type:
<a href="/files/q3-report.pdf">
Download Q3 2024 Financial Report (PDF, 1.8 MB)
</a>
Audit by searching src/ for >read more<, >click here<, >learn more<, and >download< in isolation.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Section 508 Accessibility Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- wcag:2.2 · 2.4.4 — Link Purpose (In Context)
- wcag:2.2 · 2.4.9 — Link Purpose (Link Only)
- section-508:2018-refresh · 502.3.7 — Hierarchical Relationships — Link Text
Taxons
History
- 2026-04-18·v1.0.0·Initial import from gov-section-508·automated