Skip to content
atlookup

Buttons with empty Text

A <button> with no visible text and no aria-label is announced as just "button" — screen-reader users have no idea what it does.

notice Impact: medium WCAG 4.1.2 (Level A) BUTTON_EMPTY_TEXT 2 min read Updated

Why it matters

A <button> with no visible text and no aria-label is announced as just "button" — screen-reader users have no idea what it does.

Address when convenient — notices usually mark a polish opportunity rather than a defect. Estimated SEO impact: medium — measurable effect on click-through or relevance.

How to fix

  • Add visible text inside the button
  • For icon-only buttons, add aria-label="..." describing the action
  • Provide a tooltip via title attribute as a fallback

Common causes

If the rule is firing across many pages, the root cause is almost always one of these:

  • Mixed-content sub-resources from before HTTPS migration that escaped the rewrite.
  • CDN or upstream proxy strips a security header that was set at the origin.
  • Legacy redirects send HTTPS traffic through HTTP first.
  • Test/staging hostnames leak into production HTML via hard-coded URLs.

Anti-patterns to avoid

Even with the best intentions, these "fixes" make the issue worse — recognise them so you don't ship them:

  • Mixed HTTP/HTTPS resources after migration.
  • Self-signed or expired certificates on production.
  • Long-lived secrets in client-rendered HTML or JS bundles.

How atlookup detects this

Our crawler renders each page with a real headless browser, then inspects HTTPS state, response headers, mixed content, and certificate validity. Pages where the rule fires for buttons with empty text are flagged on the report.

If you'd like to see this rule fire on your own site, run a free 60-second audit — every page is reported with the exact lines that triggered it.

Tools to verify the fix

Once you've applied the fix, double-check with these external validators:

Frequently asked questions

Why does Buttons with Empty Text matter for SEO?

A <button> with no visible text and no aria-label is announced as just "button" — screen-reader users have no idea what it does.

How do I fix buttons with empty text?

Add visible text inside the button For icon-only buttons, add aria-label="..." describing the action Provide a tooltip via title attribute as a fallback

Is this a critical SEO issue?

Address when convenient — notices usually mark a polish opportunity rather than a defect. Estimated SEO impact: medium — measurable effect on click-through or relevance.

How does atlookup detect buttons with empty text?

Our crawler renders each page with a real headless browser, then inspects HTTPS state, response headers, mixed content, and certificate validity. Pages where the rule fires for buttons with empty text are flagged on the report.

Does this affect accessibility?

Yes. This issue maps to WCAG 4.1.2 (Level A). Fixing it improves both SEO ranking signals and the experience for users on assistive technology.