What should alt text communicate?

Describe the information or function someone needs from this image on this page. For an HTML image, the alt attribute commonly supplies that alternative. W3C’s image tutorial explains purpose-based choices.

The same photograph can need different wording in a product listing and a photography lesson. Start with why the image is present, rather than describing every visible object.

Accessibility and search context

A useful alternative lets people understand meaningful image content without seeing it. WCAG 2.2’s non-text-content criterion requires equivalent-purpose alternatives, with exceptions for specified situations. Read the criterion and its exceptions. This is a technical standard, not a jurisdiction-specific legal conclusion.

Google combines alt text with page content and visual analysis to understand an image. It warns against keyword stuffing. Google’s image guidance does not establish a fixed ranking boost or a top-three signal weight.

Inspect the actual element

For this illustrative product photograph, a useful alternative identifies the distinguishing visible feature:

<img src="example-chair.jpg" alt="Oak dining chair with a woven seat" />

The filename and product are examples. Check the actual image before adopting the wording. A CMS title, attachment label or caption is not automatically the image’s rendered alt attribute.

Choose the alternative by purpose

Image purpose and alternative
PurposeApproachIllustrative wording
InformativeConvey essential information.Oak dining chair with a woven seat.
DecorativeUse an empty alt for an HTML image.alt=""
FunctionalDescribe the action or destination.Download the fitting guide.
ComplexPair a short identification with an accessible full explanation.Service workflow; full steps follow.

These categories follow W3C’s tutorial. The alt decision tree helps check the purpose before choosing wording.

Illustrative review: a guide-download icon

Suppose a link contains only a document icon. Blue document icon describes its appearance but leaves the destination unclear. A name such as Download the fitting guide explains the task.

If visible link text already gives that same name, review the complete link so the icon does not repeat the label unnecessarily. Test the rendered accessible name, not just the image field. This is an example, not a claim about an existing customer site.

A caption is visible text associated with an image. An alt attribute supplies a text alternative. Give each a purpose rather than copying both automatically.

For a complex chart or diagram, a short alternative alone may omit the important relationships. Provide an accessible complete explanation or data alongside it. W3C’s complex-image guidance shows ways to connect these descriptions.

Describe the actual data, units and relevant pattern. Do not insert benchmark numbers solely to make an example look researched.

Review images in their page context

  1. Identify whether each image conveys information, performs an action, or decorates the page.
  2. Read the surrounding text and check the visible image.
  3. Write the minimum wording that preserves the needed meaning.
  4. For a linked image, check the whole link’s accessible name.
  5. Provide accessible detail for a chart or diagram.
  6. Inspect the published markup and review it with suitable accessibility tools and manual checks.

Avoid a character-limit shortcut

Do not replace a useful alternative with incomplete wording just to meet an arbitrary count. The cited W3C guidance defines the purpose of the alternative, not a universal screen-reader cutoff.

An empty alt can be correct for decoration. A missing alt attribute and a deliberately empty one are different markup choices. Automated checks need a contextual review to determine whether the chosen alternative actually communicates the image’s purpose.

Questions readers ask

What about words shown only inside an image?

When those words convey needed information that is not available elsewhere, include their equivalent in the text alternative. Prefer real text where possible.

Does an inline SVG use the same alt attribute as an img?

Inline SVG uses a different naming mechanism. Google illustrates a title element connected with aria-labelledby. Check the resulting accessible name rather than treating the SVG as an img element.

image SEO, accessible content, meta descriptions, Core Web Vitals.

Primary references

Source guidance checked on October 12, 2026. Examples are illustrative; no customer outcome or human expert review is claimed.