Course contentsShow
← Web Development
Lesson 1145 of 2,98220. Screen Readers and Assistive TechnologyFree lesson

Alt Text for Complex Images

Using figure and figcaption, or linking to long descriptions for diagrams, infographics, and technical illustrations.

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.