← Back to blog

Accessible Images in EPUB: Alt Text, Captions, Descriptions

October 26, 2026
Accessible Images in EPUB: Alt Text, Captions, Descriptions

An image in an EPUB is accessible when a reader who cannot see it still gets what it contributes. That means a short text alternative in the alt attribute for images that carry meaning, an empty alt="" for images that are only decoration, and a linked long description for anything complex, such as a chart, a map, or a diagram. This guide walks through each decision in the order you make it while preparing a book, then shows how to test the finished file.

Alhora
Prepare Accessible, Polished eBooks
Alhora helps authors format eBooks with real-time validation against publishing standards, supporting a more reliable path from manuscript to finished file.
Explore Alhora

Key takeaways

  • Sort every image into one of three groups before you write anything: informative, decorative, or complex. The group decides the markup.
  • Keep alt text short. Put long explanations in a separate linked description and connect it with aria-details.
  • Do not put text inside images when it can be live text. Images of text fail non-visual readers.
  • Declare what your book contains in the accessibility metadata, then test the exported file in real reading systems, not only in a validator.

Table of Contents

Why image accessibility is a publishing task, not a nice extra

Screen reader users, people with low vision, and readers using text-to-speech all depend on what you put in the markup. An EPUB is HTML inside a zip package, so the same rules that govern web images apply. The W3C's EPUB accessibility techniques note that using images in most instances leads to text not being accessible to non-visual users, which is why replacing text with pictures is the first habit to drop.

For novelists the job is usually small: a cover, a map, a few ornaments, and maybe a scene-break glyph. For nonfiction, textbooks, cookbooks, and children's books, images are the content, and every one needs a decision. Either way the process is the same, and it is faster when you do it once, early, rather than after export.

If you want the wider picture first, our EPUB accessibility checklist covers the whole package, and Images in EPUB: A Practical Guide for Ebook Creators covers file formats, sizing, and placement.

Step 1: Sort each image into informative, decorative, or complex

Start with an inventory. List every image in the manuscript, including chapter ornaments and scene-break graphics, and put each one in a group.

GroupWhat it isWhat it needs
InformativeA photo, illustration, or simple diagram the reader needs to understand the textA brief alt value, or a description in the surrounding text
DecorativeBorders, spacers, flourishes, ornamental breaksAn empty alt=""
ComplexCharts, maps, multi-part diagrams, infographicsA brief alt plus a linked extended description

The DAISY Accessible Publishing Knowledge Base states the rule for informative images: an image central to understanding must have a text alternative unless the surrounding text already describes it. If your paragraph says "the map below shows the route from the harbor to the keep" and then describes it in full, the image may not need a separate description at all. Do not describe it twice.

A quick test for each image

Ask three questions:

  1. If this image vanished, would the reader lose information or meaning?
  2. Is that information already stated in the nearby text?
  3. Could the information be written in one or two short sentences?

If the answer to the first is no, the image is decorative. If yes to the first and no to the second, it is informative or complex. If it cannot be said in two sentences, it is complex and needs a longer description.

Step 2: Mark decorative images so assistive technology skips them

Decorative images are the easiest to get wrong, because the instinct is to describe everything. A screen reader that announces "ornament, ornament, ornament" at every scene break is tiring to listen to. The DAISY guidance on decorative images says purely decorative images such as borders or spacers must carry an empty alt attribute, alt="", so assistive technologies ignore them.

The same page notes that adding role="presentation" gives extra assurance that the image is ignored. The markup looks like this:

<img src="images/ornament.svg" alt="" role="presentation" />

Two cautions. First, never omit the alt attribute entirely. A missing attribute and an empty one are different things, and only the empty one tells the reader's software to skip the image. Second, if your scene break is a real structural break that matters to the reader, consider marking it with a thematic break element and styling it with CSS, so there is no image to manage at all.

Decorative dividers bypassed by the reading path

Step 3: Write alt text that earns its place

Good alt text is short, specific, and limited to what the image shows. Three rules cover most cases.

Keep it brief and let the reader choose more

The DAISY knowledge base says alternative text should be very brief, so the user can decide whether to read an extended description. Think of alt text as the label, not the explanation. One short sentence, or a phrase, is usually enough.

Answer the journalist's questions, and only those the image answers

The same guidance suggests effective alt text answers the who, what, where, when, why, and how that is relevant to the image, without adding information that is not in the visual itself. So do not smuggle in the author's intent or backstory that a sighted reader could not see.

WeakBetter
Image of a lighthouseRed-and-white lighthouse on a rocky headland at dusk
ChartBar chart of annual book sales rising from 2021 to 2025 (full data in the linked description)
Photo of authorPortrait of the author seated at a desk, smiling

Do not announce the format

Apple's Books asset guide tells authors not to use the word "image" in alt text, because VoiceOver may announce it redundantly. The same logic applies to "picture of" and "photo of" in most cases. The screen reader already says it is a graphic. Lead with the subject.

The exception is when the medium matters to meaning. "Pencil sketch of the family farmhouse" tells the reader something real, because the style is part of the content.

Writing for different book types

  • Fiction: Most images are maps, ornaments, and a cover. Describe the map's content briefly, and give the cover a short descriptive alt.
  • Memoir and history: Photos need who, where, and when if the caption does not already say so.
  • Cookbooks: Describe the finished dish only if the text does not. Step photos that duplicate numbered instructions can be brief.
  • Children's books: The picture often carries the story. Describe action and emotion, since the text may not.

Step 4: Handle captions without repeating yourself

Captions and alt text do different jobs. A caption is visible to everyone and usually adds context: a credit, a date, a place. Alt text describes what is seen for someone who cannot see it. If your caption says "The harbor at Falmouth, 1932", the alt text does not need to repeat the place and year. It can describe what is visible: boats moored along a stone quay under a cloudy sky.

Caption context paired with distinct image description

Structurally, the DAISY guidance recommends using a figure element to enclose an important image that is not required to be read at its point of insertion. Put the img and a figcaption inside it:

<figure>
  <img src="images/harbor.jpg" alt="Boats moored along a stone quay under a cloudy sky" />
  <figcaption>The harbor at Falmouth, 1932.</figcaption>
</figure>

That keeps the picture and its caption together in the reading order and gives assistive technology a clear grouping.

Step 5: Add long descriptions for charts, maps, and diagrams

Some images cannot be summarized in a sentence. A line chart with four series, a family tree, a technical cross-section: these need an extended description. According to the DAISY knowledge base, alt text is added through the img element's alt attribute, while extended descriptions can be linked with a hyperlink, with aria-details on the image referencing the link's ID. When possible, it advises placing the linked description in its own file.

A working pattern:

  1. Write a brief alt: "Line chart of monthly downloads by format, 2021 to 2025."
  2. Place a visible or discreet link after the figure: "Description of chart".
  3. Give that link an id, and set aria-details on the image to that ID.
  4. Put the full description, ideally including a data table, in a separate XHTML file or a back-of-book section, with a link back to the figure.
<img src="images/downloads.png" alt="Line chart of monthly downloads by format, 2021 to 2025" aria-details="desc-downloads" />
<a id="desc-downloads" href="descriptions.xhtml#downloads">Description of chart</a>

The DAISY transition guide on extended descriptions recommends hyperlinks over the details element because hyperlinks are supported more consistently across EPUB reading systems. A collapsible block looks neat in your preview and may fail on a reader's device, which is the wrong trade.

What belongs in a long description

  • For a chart: the type, the axes, the trend, and the underlying numbers, ideally as a table.
  • For a map: the area covered, key locations, and their relationships.
  • For a diagram: the parts, in the order a reader should follow them.

Write it as plain prose and structured data a reader can navigate, not as a second caption.

Step 6: Keep text out of images

Text inside a JPEG or PNG cannot be resized, restyled, or read aloud unless you describe it. If a quote, a sign, or a heading can be live text, set it as live text. The Fitchburg State accessibility guide for course materials makes the same point in its EPUB section: use images for pictures, not for tables or text content.

When the text must be graphic, as in a logo, a sign inside an illustration, or a hand-lettered title, put its exact words in the alt text. For tables, use real table markup. A screenshot of a table fails on every count.

Fixed-layout books need the same care

Picture books, comics, and cookbooks often use fixed layout, where space is tight. The DAISY guidance on fixed-layout images says these books need the same descriptive standards as reflowable ones, though space constraints may require hiding descriptions with CSS or ARIA techniques that remain available to screen readers.

Another caution from the same knowledge base, on fixed-layout HTML: even a well-built fixed-layout file may still be hard to use if the reading system stops people from scaling text or changing contrast. You cannot control every device, so test on the ones your readers use, and consider whether a reflowable edition is the better primary format for text-heavy titles.

Step 7: Declare it in the metadata

Accessible markup helps only if readers and stores can tell what is inside. The W3C's EPUB accessibility techniques say publishers should specify the required access modes, such as textual and visual, in the publication metadata using schema:accessMode. That lets a reader see whether the book works for their needs. If your book contains images that carry meaning, visual belongs in that list next to textual, and your descriptions are what make the textual route complete.

For how this connects to conformance claims, see our guide to WCAG EPUB compliance.

Step 8: Test the finished file

A validator tells you the package is well formed. It cannot tell you whether an alt value is any good. Test in two layers.

  1. Automated: run EpubCheck and an accessibility checker. Look for images with missing alt, broken description links, and empty alt on images that carry meaning.
  2. Human: open the file in a screen reader or read-aloud mode. Listen to a chapter with images. Do the descriptions make sense without the picture? Do decorative images stay silent? Do links to long descriptions work and return you to the right spot?

It also helps to know that reading systems differ. The public results on epubtest.org include a Fundamental Accessibility Test in its Read Aloud group that checks whether image alternative text is announced. The page for Play Books on Android, dated 14 March 2025, is one example of how that is reported. Results vary by app and platform, so run your own check on each store's reader.

Store-specific rules matter too. Our guides cover Kobo EPUB formatting and Google Play Books requirements if you distribute through those channels. Complex content has its own page: see MathML in EPUB for equations and SVG in EPUB for vector graphics.

Our perspective: treat descriptions as part of the manuscript

We build Alhora for authors who want a professional finish, and we see the same pattern in image accessibility. The markup is not the hard part. The hard part is that alt text is writing, and nobody can write it for you without losing the author's judgment about what matters in the picture.

That is why Alhora's AI checks and never writes. Our assistant, Inkia, flags issues for you to fix. It does not write or alter creative content, and that principle extends to descriptions of your images. You decide what a reader needs to know, and the tool makes sure nothing is missed, such as an informative image with no alternative or a broken link to a description.

Our export is audit-gated for accessible EPUB: the file is checked before it leaves the studio, so a missing alt attribute shows up while you can still fix it in the manuscript, not after a store rejects the upload or a reader complains. Our practical advice has three parts. Write alt text while you place the image, not at the end. Keep a short style note for your series, such as how you describe maps or whether you name characters in portraits, so a ten-book run stays consistent. And listen to one chapter read aloud before every release. Ten minutes of listening finds problems no checker will.

For the step-by-step export workflow, including InDesign sources, read Make Accessible EPUBs From InDesign.

— James

Build accessible images into your workflow with Alhora

If you are formatting a book now, Alhora takes a manuscript to a typeset EPUB with live validation against publishing standards, so image and accessibility issues surface as you work. It runs on Mac, Windows, Linux, and ChromeOS. The lifetime license is listed at £99 one-off. You can also read how to choose book formatting software before you commit.

A short checklist to run before every export

  • Every image is sorted into informative, decorative, or complex.
  • Decorative images have alt="", and none lacks the attribute.
  • Alt text is brief, avoids the word "image", and adds nothing that the picture does not show.
  • Captions and alt text do not repeat each other.
  • Complex images link to a description with aria-details, ideally in a separate file.
  • No meaningful text is trapped in a bitmap.
  • Access modes are declared in the metadata.
  • You have listened to a read-aloud pass on at least one real reading system.

FAQ

Do all images in an EPUB need alt text?

No. Images that carry meaning need a text alternative, unless the surrounding text already describes them. Purely decorative images should have an empty alt="" so assistive technology skips them. What you must never do is leave the attribute off.

How long should alt text be?

As short as it can be while still useful. Alt text works as a brief label that lets readers decide whether to open a longer description. If you need more than a sentence or two, move the detail to an extended description linked with aria-details.

How do I describe a chart or diagram in an EPUB?

Give the image a short alt that names the type and subject, then link to a full description in its own file. Include the trend and the underlying data, preferably as a table. Connect the two by setting aria-details on the image to the ID of the link.

How do I add a photo to an EPUB?

Place the image file in the package, reference it with an img element, and set its alt value. If the photo has a caption, wrap both in a figure with a figcaption. In a formatting tool such as Alhora you insert the image in the manuscript and add the description there, and the export handles the package structure.

Sources