Email Accessibility6 min read

Email Image Captions, Alt Text, and Body Copy Have Different Jobs

A caption adds visible context, alt text supplies a text alternative, and body copy must carry information every recipient needs to act on.

Written by
Marketing Wiki Research Automation
Review status
Not independently reviewed
Published
Updated
Evidence checked
Sources
4
Direct answer

Decide what belongs in a visible image caption, HTML alt text, nearby body copy, or nowhere, with an email review worksheet.

An email image caption, its HTML alt text, and the surrounding body copy are not interchangeable. Use the caption for context every sighted reader should see, alt text for the image’s meaningful text alternative, and body copy for information the recipient needs regardless of whether the image loads or is perceived.

Editorial disclosure: Prepared by Marketing Wiki Research Automation under standing direct-publication authorization and not independently reviewed. Product capabilities are vendor-documented unless labeled otherwise; sources were refreshed on September 2, 2026.

Migma added image captions to its Visual Editor on August 31, 2026. The same editor separately exposes alt text for an image. That separation is useful: it gives the team distinct fields, but the editor cannot decide which sentence belongs in which field.

The four destinations#

Scroll table →
DestinationWho receives itPut this thereDo not put this there
Visible captionEveryone who sees the rendered image and captionSource, date, product variant, place, or short interpretation tied to the imageThe only copy of a critical instruction or offer term
Alt textPeople using assistive technology and recipients whose image is unavailable, depending on client behaviorA concise equivalent of the image’s purpose in this message“Image of,” decorative detail, or a second marketing paragraph
Nearby body copyEvery recipient in the normal reading flowDecision-critical fact, qualification, price condition, deadline, or actionDetail that only identifies a decorative flourish
Empty alternativeAssistive technology should skip a decorative image when implemented correctlyNothing, when the image adds no meaning and the email code marks it decorativeAn informative or linked image

The table is a writing tool. Final accessibility depends on the generated markup and receiving client, so inspect the result rather than approving field labels alone.

Start with the image’s job in this email#

W3C’s images guidance separates informative, decorative, functional, complex, and text images. The same asset can change category when its job changes.

A shoe photo beside the product name and price may be partly illustrative; alt text such as “Blue trail shoe with orange sole” can convey the choice the image helps make. The same photo used as a linked product card is also functional, so the link’s accessible name and destination matter. A texture behind a fully written headline may be decorative. A chart summarizing experiment results is complex and needs more than a filename or one vague sentence.

Ask: if the image disappeared, what meaning or action would the recipient lose? That answer defines the content that needs an equivalent. It does not automatically define the exact alt text; some essential information belongs in ordinary body copy so everyone gets it.

When a caption earns its place#

Use a visible caption when the note improves interpretation for all sighted readers but would interrupt the main paragraph. Common examples include:

  • “Prototype shown; final packaging may change.”
  • “Storefront in Girona, August 2026.”
  • “Dark-mode preview in Outlook for Windows.”
  • “Results cover the treatment group from the August 12 test.”

Migma documents that captions inherit the brand’s font and colors. That is a presentation capability, not evidence that the caption has sufficient contrast, survives every export, or is programmatically associated with the image. Review the actual output.

Do not hide an offer restriction in a tiny caption. If the recipient must know that a discount excludes subscriptions, put the restriction in the normal offer copy as well. The team should not depend on a visual relationship that may weaken when the email reflows.

Write alt text as an equivalent, not a label#

Weak alt text inventories pixels: “Image,” “banner,” or “woman holding product.” Useful alt text explains the purpose the image serves in this specific message: “Mara holding the compact brewer beside a carry-on bag.” If the nearby heading already says “Compact brewer,” remove repetition and keep only the additional meaning.

For an image containing words, move important words into real HTML text when possible. If the image is the only place a campaign date appears, a concise alternative is necessary but still leaves other readers vulnerable when images are blocked. Put the date in body copy.

For a chart, provide the conclusion and relevant values in nearby text or a linked accessible detail page. Alt text can identify the chart and summarize its purpose; it is rarely a good container for an entire dataset.

Handle linked images separately#

When an image is clickable, the control needs a useful accessible name. “Shop the blue trail shoe” describes the action better than “image” or a raw URL. Check how the destination platform nests the image and link, because the source editor may not be the final markup owner.

If a card includes linked image, linked heading, and linked button that all go to the same place, review the experience with images off and with assistive technology. Repeated identical destinations can create noise. This is an implementation review, not something a caption solves.

Image-copy worksheet#

Complete one row for every meaningful image:

Scroll table →
FieldReviewer entry
Image ID and email version
Purpose in this messageInformative / decorative / functional / complex / text
Meaning lost if unavailable
Body copy carrying essential facts
Alt text or decorative treatment
Visible caption and reason
Link destination and accessible action
Mobile and dark-mode observation
Destination-platform test result

A blank caption is not a failure. A duplicated caption is often a sign that the team has not decided where the information belongs.

Review in three passes#

First, read the email with images hidden. The offer, qualification, and action should remain understandable. Second, inspect the accessible alternative and link purpose. Third, view the normal email on desktop, mobile, light mode, and dark mode to confirm the caption is legible and remains beside the right image.

Migma can support this workflow through separate caption and alt-text controls plus its phone preview and Email Preflight. The documented product surface does not prove the final message conforms to WCAG or renders identically in every inbox. The publisher remains responsible for the received artifact.

Evidence limits#

The dated product claim is limited to Migma’s documented caption feature and existing image controls. W3C sources support the distinction between image purposes and text alternatives. Marketing Wiki did not run an assistive-technology or client-panel test for this article, and this is not legal advice.

Evidence

Sources behind this page

Claims remain tied to dated source review. Method and corrections stay public.

  1. S-01Migma Product Changelogdocs.migma.ai
  2. S-02Migma Visual Email Editordocs.migma.ai
  3. S-03W3C Images Tutorialw3.org
  4. S-04WCAG 2.2 Non-text Contentw3.org