Writing & StyleStyle guide

Writing Image-Map Text Alternatives

Writing Image-Map Text Alternatives records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Quick answer

For an image map, write an overall alternative that explains the map’s context and a distinct alternative for each hotspot that states its destination or action.

Key details

Core IssueW3C WAI says image maps need a text alternative for the overall image context and a text alternative for each selectable area that identifies its destination or action.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This guide covers text-alternative wording; coordinate geometry, responsive hotspot behavior, and redundant-link implementation are separate technical concerns.

Further guidance

Content

Give the image an overall contextual alternative, then give each interactive hotspot wording that identifies the linked destination, person, place, or action.

Purpose

Users who cannot perceive the map visually need both the context of the whole image and meaningful labels for each selectable region.

Sources and evidence

Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.

  1. Image Maps — W3C WAI Images Tutorial (opens in a new tab)World Wide Web Consortium (W3C) · W3C WAI guidance for overall and per-hotspot text alternatives in image maps.

Related guides

Writing & Style

Writing Concise Image Text Alternatives

Writing Concise Image Text Alternatives records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Explore the topic