NeovaAdvanced SEO Platform

Images Must Have Alternate Text

In Neova Runs from the crawl itself: nothing to set up.

Rule last reviewed October 17, 2026 · Guide updated July 1, 2026

Every <img> needs an alt attribute: a short text equivalent when the image carries meaning, alt="" when it is decorative, or role="none" or "presentation" (WCAG 2.2 SC 1.1.1, Level A; technique H37).

How Neova Finds It

Neova reads the HTML of every page it crawls and looks for this.

Why It Matters

Image optimization affects page speed, accessibility, and how AI systems understand visual content.

The Ticket It Writes

IM-002 · Images Must Have Alternate Text

How to Check the Fix: 1. Run the check again in Neova
2. Spot-check sample URLs across affected templates
3. Record the re-check date and period label next to the baseline

Neova writes this ticket for every affected page group and sends it to Jira, Linear, Asana and the rest, after you approve it.

The Full Guide

TL;DR: Every <area> in an image map is a clickable link, and each one needs an alt attribute describing where it goes. Miss it and screen reader users hit an unlabeled hotspot they cannot use. Add a short, destination-focused alt to each area.

Element Code: IM-002

TYPE
Accessibility / images
SEVERITY
Medium
AFFECTS
Screen readers, links
STANDARD
WCAG 1.1.1
FIX EFFORT
Per hotspot

What an Area Element Is

An image map lets you carve one image into multiple clickable regions. It uses a <map> with child <area> elements, each defining a shape (rect, circle, poly) and a link. Classic example: a floor plan or a diagram where different parts click through to different pages.

<img src="office.png" usemap="#plan" alt="Office floor plan">
<map name="plan">
  <area shape="rect" coords="0,0,120,90" href="https://example.com/reception" alt="Reception desk">
  <area shape="circle" coords="200,80,40" href="https://example.com/lab" alt="Research lab">
</map>

Here is the part people miss: each <area> is functionally a link, and the HTML spec requires an alt attribute on any area that has an href. The image's own alt describes the picture. The area's alt describes that specific clickable destination. They are not the same thing, and one does not cover for the other.

Why the Missing Alt Matters

Screen readers announce the alt as the link name. When someone tabs to an area hotspot, assistive tech reads its alt text as the accessible name of that link. No alt, and the user hears something useless like the file name or "link" with no context. They are staring at an unlabeled door.

It is a WCAG failure. Missing alt on a linked area fails Success Criterion 1.1.1 Non-text Content. Automated checkers like axe, WAVE, and Lighthouse all flag it, and it is a common item on legal accessibility complaints.

Links without discernible text are weak SEO too. A link whose only content is an unlabeled image hotspot gives search engines no anchor context. The area alt is the anchor text equivalent for image map links, so leaving it blank throws away a real signal.

Empty is not always wrong, though. If an area is purely decorative or overlaps another that already carries the link, an intentionally empty alt="" is the correct way to hide it from assistive tech. The failure is a missing alt on a functional link, not a deliberately empty one.

How a Screen Reader Sees It

One image, three hotspots area A area B area C No alt: "link" user has no idea alt="Reception" clear destination Same hotspot, two outcomes. The alt is the only thing standing between a usable link and a dead end.

How to Detect It

Tool How to Check What It Reports
axe / WAVE Run the a11y extension on the page "Image map area missing alternative text"
Lighthouse DevTools accessibility audit Fails the area alt audit
Screaming Frog Custom extraction of area elements without alt Site-wide list of offending pages
Real screen reader Tab through hotspots with VoiceOver or NVDA You hear which links have no name

The automated tools catch the missing attribute instantly. But I always tab through a real image map with VoiceOver at least once, because "has an alt" and "has a useful alt" are different tests, and only your ears catch the second one.

How to Fix It, Step by Step

1. List every area with an href. Those are your functional links and every one needs alt text.

2. Write destination-focused alt. Describe where the link goes, not what the pixels look like. "Reception desk" or "View pricing", not "orange rectangle top left".

3. Keep it short. These behave like anchor text. A few words is plenty. Skip "link to" and "image of", the screen reader already announces it as a link.

4. Handle decorative overlaps deliberately. If an area is redundant or purely decorative, give it alt="" on purpose so assistive tech skips it cleanly. That is a decision, not an omission.

5. Consider whether you even need an image map. Honestly, image maps are fragile: they do not reflow on mobile and the coordinates break on resize. A block of real links or an SVG with proper labels is usually a better answer. If you can replace the map, that solves this at the root.

6. Re-run the audit. Confirm axe or Lighthouse shows zero area alt errors, then verify by ear.

DO vs DON'T

DO

  • Add alt to every area that has an href
  • Describe the destination, like "Contact page"
  • Use alt="" on purpose for decorative overlaps
  • Test by tabbing through with a screen reader
  • Prefer real links or labeled SVG when you can
DON'T

  • Leave a linked area with no alt attribute
  • Assume the image's alt covers the hotspots
  • Start alt text with "link to" or "image of"
  • Describe shapes and colors instead of destinations
  • Stuff keywords into hotspot alt text

What Good Looks Like

Every clickable area carries a short alt that names its destination, decorative areas are intentionally empty, and the image itself has its own descriptive alt. A user tabbing through with NVDA hears a clean list of named links, axe and Lighthouse report zero area alt issues, and search engines get real anchor context from each hotspot. Better still, on pages where the image map added nothing but fragility, you replaced it with plain labeled links and the whole problem disappeared.

FAQ

Does the Image's Alt Cover the Areas?
No. The img alt describes the whole picture. Each linked area needs its own alt because each is a separate link with its own destination. They serve different purposes.
Is an Empty alt="" Ever Correct on an Area?
Yes, when the area is decorative or duplicates a link already provided elsewhere. An intentional empty alt tells assistive tech to skip it. The problem this check flags is a missing alt on a functional link, not a deliberate empty one.
Should I Just Stop Using Image Maps?
Often, yes. Image maps do not reflow on small screens and their coordinates break when the image scales. A set of real links or a labeled SVG is usually more robust and more accessible. If a map is not essential, replacing it is the cleanest fix.
What Should the Alt Text Actually Say?
Name the destination in a few words, the way you would write good anchor text. "View pricing" or "Reception desk" works. Skip "link to", "click here", and descriptions of shape or color.
Want every accessibility and image issue found in one pass?

An advanced audit catches missing area alt, image map problems, and the full sweep of a11y and crawl issues, then hands you exactly what to fix and where.

Written by Neova Labs · Back to the Check Library