link.text.vague
- Default
- warn
- Options
{"words":["click here","here","read more","more","learn more","link","this"]}- Plugin
link
A link text describes its target, unlike "click here".
Why: Search engines use link text to learn what the target page is about. "Click here" tells them nothing. The check ignores case and punctuation.
When off: vague link text passes.
| Option | Type | Default | Description |
|---|---|---|---|
words |
string[] |
see above | The link texts to report, in lowercase. Setting it replaces the list. |
<!-- ✗ Fails -->
<a href="/menu/">Click here</a>
<!-- ✓ Passes -->
<a href="/menu/">See our full menu</a>
rules: { "link.text.vague": { words: ["click here", "here", "go"] } }
References
- Google: Link best practices: Google calls "click here" and "read more" too generic.
- WCAG 2.2: Understanding Link Purpose (In Context): Link text should make sense on its own. Short links like "more" can be fine in context, so the rule warns.