Fixing the ‘Links Do Not Have a Discernible Name’ Error: An Accessibility Guide

In the world of web development, accessibility isn’t just a “nice-to-have”—it is a necessity for user experience and search engine optimization. One of the most common accessibility audits performed by tools like Google Lighthouse is the “Links do not have a discernible name” error. If you are seeing this alert on your SiteSuraksha security and performance reports, it means your website contains hyperlinks that screen readers cannot identify, which leaves visually impaired users unable to navigate your site effectively.

What Does This Error Actually Mean?

A “discernible name” is essentially the text or label that describes the destination or purpose of a link. When a screen reader encounters a link, it reads this name aloud. If your link is empty, or if it only contains an image without descriptive “Alt” text, the screen reader has nothing to announce, leaving the user confused about where the link leads.

Why It Matters

• Accessibility (WCAG Compliance): Ensuring your site is navigable for everyone, regardless of ability.
• SEO Benefits: Search engine crawlers use link text to understand the context of your pages. Proper naming helps define the relationship between your content.
• User Experience: Clear links provide better navigational cues for all users.

How to Fix the Issue

1. Use Descriptive Anchor Text

Avoid using generic phrases like “Click here” or “Read more.” Instead, use descriptive text that explains the destination. For example, change “Click here” to “View our website maintenance packages.”

2. Add ARIA Labels

If your design requires a link that doesn’t have visible text (such as an icon-only button), you must use an aria-label. This provides a text alternative for assistive technology without changing your visual design.

<a href="/contact" aria-label="Contact SiteSuraksha Support"><i class="fa fa-envelope"></i></a>

3. Optimize Image Links

If you have an image wrapped in an <a> tag, ensure the image has a descriptive alt attribute. Screen readers will use this text as the link name.

Need Professional Help?

Maintaining a fully accessible and secure website can be technically demanding. At SiteSuraksha, we specialize in comprehensive WordPress maintenance and security auditing. We don’t just patch vulnerabilities; we ensure your digital storefront is optimized, accessible, and performing at its peak.

Ready to elevate your site’s performance? Contact the SiteSuraksha team today to learn how we can keep your platform safe and user-friendly.