Skip to content
SilktideHelp

Empty links

Silktide finds links that contain no text at all - nothing visible and no text alternative. A person using a screen reader hears only "link", with no way to know where it goes.

<!-- Empty: an icon link with no text alternative -->
<a href="/search"><svg>...</svg></a>

<!-- Fixed: the image's alt text names the destination -->
<a href="/"><img src="logo.png" alt="Example Corp home"></a>

<!-- Fixed: an aria-label names the destination -->
<a href="/search" aria-label="Search"><svg>...</svg></a>

Why this matters

Links are how people move through your website, and not everyone can see them. A announces each link by its text; when there is none, the user hears just "link" and must guess or skip it. Many blind users also navigate by pulling up a list of every link on the page - a list of unnamed entries is useless.

Empty links usually happen by accident: an icon replaces text, an image loses its , or a stray <a> tag is left behind by an editor. Search engines are equally unable to tell what an empty link points to.

How to fix it

  1. If the link should have visible text, add it.
  2. If the link is an image, give the image alt text that names the destination, such as alt="Example Corp home" for a logo linking to your homepage - not a description of the picture.
  3. If the link is an icon, add an naming the destination, or include text hidden visually but available to screen readers.
  4. If the link is a leftover with no content and no purpose, delete it.

How Silktide tests this

  1. Find every link on each page, including image-map areas.
  2. Skip elements that lack a working link destination.
  3. Read the link's text, including alt text and text alternatives such as aria-label and title on the link and anything inside it.
  4. Report the link if no text is found at all.

Troubleshooting

A link can look fine while being empty, because its appearance comes from an icon or a background image - neither of which gives it a name. Check the underlying for a text alternative.

The icon's meaning is obvious

Only to people who can see it. A magnifying glass says "search" visually, but a screen reader cannot describe images that have no text alternative - the label has to be in the markup.

Learn more

Last updated

Was this page helpful?

Empty links | Silktide Help