Generator

Email image alt text

Email image alt text that still works when the image does not load

Email images fail in ordinary ways. A recipient may block remote images, use a screen reader, or open the message before a slow image finishes loading. The alt text has to carry the useful part without turning into another headline.

I write the first draft from the image, then edit it against the email. A product photo, an image-only button, and a decorative divider need three different answers.

Quick answer

Email image alt text should replace the image's purpose in that message. Describe a meaningful photo, name the action for an image-only link, keep important offer text in the email body, and use an empty alt attribute for decoration in custom HTML.

Sort each email image by its job

Start with the reason the image is in the email. W3C/WAI separates informative, functional, decorative, and text-bearing images because the replacement text changes with the image's purpose. That decision matters more than a character target.

The surrounding copy matters too. If the product name and offer are already written beside a product photo, the alt text can describe the visible variant or angle. If an image is the only link to a sale page, its alt text needs to name the destination or action.

  • Informative photo: preserve the detail the reader would miss.
  • Image-only link or button: name what the link does or where it goes.
  • Image containing important words: keep those words in normal email text as well.
  • Decorative image in custom HTML: use alt="" so it can be skipped.

Generate the visible description first

For a product photo, editorial image, or screenshot, I upload the image to AltCaption and generate a plain description. That gets the visible subject, color, setting, and other concrete details into a draft without asking the model to invent the campaign message.

Then I compare the draft with the email. I remove details already stated in the nearby copy, correct product names and variants, and add the image's purpose when the pixels alone do not explain it. AltCaption cannot know where a linked image goes or which sentence the recipient has already read.

  • Keep visible product details that distinguish the photo.
  • Remove promotional claims that the image cannot establish.
  • Add a verified product or campaign name when the reader needs it.
  • Read the draft beside the subject line, heading, caption, and link destination.

Treat product photos and offer graphics differently

A product photo usually needs the item and the useful visible detail. A hero graphic made from a product photo plus a discount headline carries two jobs: showing the item and communicating the offer.

Keep the offer in live email copy instead of relying on the graphic. The image alt text can identify the product or visual, while the normal heading and link text preserve the price, date, or discount when images are unavailable. This also avoids making the alt attribute repeat a whole promotional panel.

  • Product photo: "Sage linen shirt with short sleeves, front view".
  • Offer graphic: use "Sage linen shirt on a model" and keep "20% off through Friday" in live text.
  • Do not add urgency, quality claims, or savings that are not visible and verified.
  • Do not repeat the same sentence in the heading, caption, and alt text.

Name the action for image-only links

When an image is the only content inside a link, W3C/WAI recommends text that describes the link's function rather than its appearance. A shopping-bag icon linked to a collection needs an action such as "Shop the linen collection," not "White shopping bag icon."

A normal text button is easier to understand and test than a button drawn into an image. When the design still uses an image-only link, verify the exact destination before writing the alt text. Do not promise "Buy now" when the link only opens a product overview.

Add the text in the builder or HTML

Email builders usually expose an alt-text field for an image block. Mailchimp, for example, documents an Alt field in its current and legacy builders. In a custom template, put the text in the image element's alt attribute and escape quotation marks before pasting it.

In a custom template, set a meaningful image's alt attribute to the approved text. Use an empty value for a decorative image. The examples below show both forms. Do not omit the attribute and hope the email client will make the right choice.

Builder behavior and email-client rendering vary. Mailchimp notes that some clients may not display alt text for a linked image or may clip text wider than the image. Keep the draft concise, then test the actual campaign instead of judging the source field alone.

Test the email with images blocked

Send a test message from the same builder and template that will send the campaign. Open it with images disabled and follow the reading order from the subject line through the final link. The email should still identify the offer, product, or next action without depending on a picture.

Then check the message with the accessibility tools and assistive technology your team normally uses. Fix repeated text, unexplained image links, missing offer details, and decorative file names before scheduling the send.

  • The main message remains in normal text when images are blocked.
  • Every image-only link names the correct action or destination.
  • Meaningful photos have useful descriptions without copied sales copy.
  • Decorative images do not announce a file name or empty link.
  • The final test uses the sent email, not only the builder preview.

Examples

  • Product photo: "Sage linen shirt with short sleeves, front view"
  • Linked collection graphic: "Shop the summer linen collection"
  • Screenshot: "Order dashboard showing three shipments delayed by weather"
  • Offer image with live offer copy nearby: "Blue running shoe on a track"
  • <img src="shirt.jpg" alt="Sage linen shirt with short sleeves">
  • <img src="divider.png" alt="">

Common questions

Should email alt text repeat the headline?

Usually not. Keep the headline as normal email text, then use the alt text for the image detail or function that the headline does not provide.

How long should email image alt text be?

Use the shortest wording that preserves the image's purpose. Mailchimp recommends one or two sentences and warns that some clients may clip text that is wider than the image, so test the sent email with images blocked.

What should I write for an image-only email button?

Name the action or destination, such as "View the order" or "Shop the linen collection." Check the link before sending so the text matches where it goes.

Should decorative email images have alt text?

In custom HTML, give a purely decorative image an empty alt attribute with alt="". In a visual email builder, check how that builder represents decorative images and test the sent message.

Can AltCaption add the text to my email campaign?

No. AltCaption generates the image description. Review it against the email, then paste the approved text into your builder or custom template and send a test message.

Related guides

Sources

Draft the description before opening the email builder

Upload the campaign image or paste its public URL. Generate the visible description, then edit it for the email's copy, link, and purpose before sending a test.

d0581bec8e830ae8adafdfcde1269f1a88edd29c