Complex Images: Charts, Maps, and Long Descriptions
Handle images that need more than a short phrase.
Complex Images: Charts, Maps, and Long Descriptions is a free Web Accessibility Academy lesson on CoddyKit — lesson 4 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Web Accessibility Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
When Alt Is Not Enough
Some images carry too much information for a short phrase. Charts, maps, and diagrams need a longer description plan.
Start With a Short Alt
Even a complex image still gets a brief alt that names it, like a bar chart of monthly sales for 2024.
<img src="chart.png" alt="Bar chart of monthly sales for 2024">Then Add the Detail
The short alt names the image; a nearby long description then conveys the actual data or relationships it shows.
Describe the Insight
A great long description gives the takeaway, like sales peaked in December, not a dry list of every single value.
The Data Table Fallback
For charts, the strongest alternative is often a real HTML table with the same numbers right below the graphic.
Linking to a Description
You can place a long description on the page and connect it with aria-describedby pointing to its element id.
<img src="map.png" alt="Store map" aria-describedby="mapdesc">Figure and Figcaption
Wrap an image and its visible explanation in figure and figcaption so the pairing is clear to everyone.
<figure><img src="flow.png" alt="Checkout flow"><figcaption>Three-step checkout</figcaption></figure>Maps Need Their Data
A map image is useless without the underlying facts, so provide an address, directions, or list as the text equivalent.
Diagrams and Flows
For a flowchart, describe the steps and their order in prose, so the logic survives without the visual layout.
Keep It Discoverable
Make sure the long description is easy to find. A hidden text equivalent users cannot reach is no help at all.
Match Effort to Complexity
The richer the image, the more your text equivalent must do. Let the image's complexity set how much you write.
Quick Check
Choose the best plan for a complex chart.
Recap
You did it! Complex images get a short alt plus a real text equivalent, a data table, figcaption, or aria-describedby that conveys the insight.
Frequently asked questions
Is the “Complex Images: Charts, Maps, and Long Descriptions” lesson free?
Yes — the full text of “Complex Images: Charts, Maps, and Long Descriptions” is free to read here on the web, and the Web Accessibility Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Web Accessibility Academy course, upgrade to CoddyKit PRO.
What will I learn in “Complex Images: Charts, Maps, and Long Descriptions”?
Handle images that need more than a short phrase. You practise Web Accessibility Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Web Accessibility Academy?
No prior experience is required. Web Accessibility Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 4 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Complex Images: Charts, Maps, and Long Descriptions” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Web Accessibility Academy lesson?
Yes. Every Web Accessibility Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Informative vs Decorative: The First Decision
- Writing Alt That Conveys Purpose, Not Pixels
- Empty alt and the Hidden Decorative Image
- Complex Images: Charts, Maps, and Long Descriptions