---
title: "Link has no accessible name (a11y/link-name)"
description: "a11y/link-name: Links without discernible text (e.g. Add link text, aria-label, or alt text on the image inside the link."
canonical: https://void-design.vercel.app/rules/a11y/link-name
lastModified: 2026-09-16
---

# Link has no accessible name

`a11y/link-name` · severity **error** · category Accessibility · detected by `void a11y` and `void audit`

## Why it matters

Links without discernible text (e.g. icon links) are announced only as "link".

## How to fix it

Add link text, aria-label, or alt text on the image inside the link.

## Example

```
<a href="https://github.com/org" aria-label="GitHub"><svg aria-hidden="true">…</svg></a>
```

## References

- https://dequeuniversity.com/rules/axe/4.13/link-name

## More accessibility rules

`void a11y` reports 48 rules in this category. WCAG 2.2 AA through axe-core, plus checks axe can't do alone: visible keyboard focus, 24/44px target size on mobile, 320px reflow and disabled zoom.

- `color-contrast` Text has insufficient color contrast — [a11y/color-contrast](https://void-design.vercel.app/rules/a11y/color-contrast)
- `image-alt` Image has no text alternative — [a11y/image-alt](https://void-design.vercel.app/rules/a11y/image-alt)
- `button-name` Button has no accessible name — [a11y/button-name](https://void-design.vercel.app/rules/a11y/button-name)
- `label` Form field has no label — [a11y/label](https://void-design.vercel.app/rules/a11y/label)
- `select-name` Select element has no accessible name — [a11y/select-name](https://void-design.vercel.app/rules/a11y/select-name)
- `input-button-name` Input button has no accessible name — [a11y/input-button-name](https://void-design.vercel.app/rules/a11y/input-button-name)
- `input-image-alt` Image button has no alt text — [a11y/input-image-alt](https://void-design.vercel.app/rules/a11y/input-image-alt)
- `html-has-lang` <html> has no lang attribute — [a11y/html-has-lang](https://void-design.vercel.app/rules/a11y/html-has-lang)

Detected by `void a11y` and `void audit`. Explain it in a terminal: `void rules a11y/link-name`
