BugWP logo BugWP
Back to Community
Home / Community / Theme → Generatepress

Troubleshooting 'Elements with visible text labels do not have matching accessible names' in GeneratePress

36 threads Sep 16, 2025 Theme → Generatepress

Content

If you've recently run a Google PageSpeed Insights test on your GeneratePress website, you might have encountered the accessibility warning: 'Elements with visible text labels do not have matching accessible names.' This is a common issue that has been reported by multiple users, particularly affecting the 'Read More' button links on archive pages and homepages.

What Does This Error Mean?

This warning is an accessibility (a11y) issue. Screen readers and other assistive technologies rely on proper HTML markup to interpret and announce elements to users. The error occurs when a visible text label (like the words 'Read More') does not match the non-visible aria-label attribute that describes the element's purpose to assistive tools. This creates a confusing experience for users who rely on them.

Why This Happens in GeneratePress

This is a known issue that was introduced in a specific version of the GeneratePress theme. The development team is actively discussing and working on a permanent fix for this in the theme's core code. You can follow the progress of this issue on the official GeneratePress GitHub repository.

How to Fix It: A Temporary CSS Solution

While waiting for an official theme update, you can apply a simple code snippet to resolve the warning. This fix specifically targets the 'Read More' link's aria-label to ensure it matches the visible text.

  1. In your WordPress dashboard, navigate to Appearance > Customize.
  2. Open the Additional CSS panel.
  3. Copy and paste the following code snippet:
a.more-link {
    aria-label: 'Read more';
}
  1. Publish the changes.

This CSS rule explicitly sets the accessible name for the 'Read More' link, bringing it into compliance with accessibility guidelines and eliminating the PageSpeed warning.

Other Common Causes and Solutions

While the 'Read More' link is a frequent culprit, this warning can apply to any element. If the above solution doesn't resolve your issue, consider these other troubleshooting steps:

  • Plugin Conflict: A third-party plugin might be modifying elements and creating the mismatch. Temporarily disable all plugins to see if the warning disappears. If it does, reactivate them one by one to identify the conflicting plugin.
  • Custom Code: Review any custom functions or HTML you have added to your site. Ensure that any buttons or links with visible text also have a matching aria-label attribute.
  • Page Builder Elements: If you use a page builder like Elementor, check its elements (especially buttons) for accessibility settings where you can manually add an appropriate aria-label.

Final Thoughts

Addressing accessibility warnings like this is not just about improving a PageSpeed score; it's crucial for creating an inclusive web experience for all visitors. The fix for this specific GeneratePress issue is straightforward and can be implemented immediately while the theme's developers work on a permanent solution.

Related Support Threads Support