What You'll Learn
You'll learn how to make diagrams, infographics, and technical illustrations accessible when a simple alt attribute isn't enough.
When Simple Alt Text Isn't Enough
Sometimes an image is so information-dense—like an organizational chart, architectural diagram, or data visualization—that cramming everything into the alt attribute becomes unwieldy. Screen reader users deserve access to all that information, just delivered differently.
Think of it like this: if someone called you on the phone and couldn't see your complex diagram, you wouldn't try to describe every detail in one breath. You'd either give them a structured, detailed description or point them to a text document with all the info broken down clearly.
The <figure> and <figcaption> Approach
For moderately complex images, wrap them in a <figure> element with a visible caption:
<figure>
<img src="org-chart.png" alt="Company organizational structure">
<figcaption>
The chart shows CEO Sarah Chen at the top, with three departments
below: Engineering (15 staff), Marketing (8 staff), and Operations (12 staff).
</figcaption>
</figure>
The <figcaption> provides context everyone can see and hear, reducing what the alt needs to convey.
Linking to Long Descriptions
For truly complex images (technical diagrams, detailed infographics), provide a link to a full text description:
<img src="network-diagram.png" alt="Data center network topology">
<p><a href="network-description.html">Full network diagram description</a></p>
The linked page should describe the image's content in structured, meaningful text—headings, lists, and paragraphs that convey what the image communicates visually.
Key Takeaway: When images are too complex for brief alt text, use <figure> with <figcaption> for context or link to detailed long descriptions so everyone can access the full information.