Category: Visual and Media Accessibility

Alternative Description

Also known as: Alternative Text, Alt Text, Alt Description

Simply put

Alternative description, commonly known as alternative text or alt text, is a written description that conveys the meaning of an image or other non-text content in digital material. It allows people who cannot see an image, such as those using a screen reader, to understand what the image communicates. Providing meaningful alternative descriptions is generally considered an essential part of making content accessible.

Formal definition

Alternative description (alt text) is a textual substitute for non-text content such as images, graphs, flowcharts, and other graphics in digital content, intended to convey the equivalent meaning or function of that content to users who cannot perceive it visually. It is typically exposed programmatically (for example, via an image element's alt attribute) so that assistive technologies such as screen readers can present it to the user. Effective alt text conveys the purpose and meaning of the item in context rather than merely naming it; complex visuals may require a longer description in addition to a concise alternative. Alt text is one component of accessible content and does not, on its own, guarantee overall accessibility or conformance.

Why it matters

Images and other non-text content routinely carry information that is essential to understanding a page, from a chart summarizing data to a photograph illustrating a product to an icon signaling an action. When that content lacks an alternative description, people who cannot perceive it visually, such as those using screen readers, may miss the meaning entirely or receive only the image file name. A well-written alternative description conveys the purpose and meaning of the item in context, allowing all users to reach an equivalent understanding.

Providing meaningful alternative descriptions is generally considered an essential part of making digital content accessible, and it is one of the most frequently referenced accessibility practices across recognized authorities such as Section508.gov, WebAIM, and government guidance. It is also commonly cited in the context of accessibility standards and testing, because missing or unhelpful alt text is among the more readily identifiable barriers in web content.

At the same time, alternative text is only one component of accessible content and does not, on its own, guarantee overall accessibility or conformance with any standard, nor does it ensure legal compliance. Automated tools can detect whether an alt attribute is present but generally cannot judge whether the description is meaningful in context, so manual review and testing with assistive technology remain necessary. This entry describes established practice and is not legal advice; requirements and expectations continue to evolve through regulation and case law.

Who it's relevant to

Content authors and editors

People who add images, charts, or other non-text content to web pages, documents, and other digital material are typically responsible for writing alternative descriptions that convey each item's meaning in context. This includes deciding when an image is decorative versus informative and when a longer description is needed for a complex visual.

UX designers and front-end developers

Designers and developers ensure that non-text content is implemented so alternative descriptions can be exposed programmatically, for example via an image element's alt attribute, and that assistive technologies can access them. They also help establish patterns for handling decorative images and longer descriptions.

Accessibility engineers and QA testers

Those evaluating accessibility use both automated checks and manual, assistive-technology-based testing to review alternative descriptions. Automated tools can flag missing alt attributes but generally cannot assess whether a description is meaningful, so human review is required to judge quality and context.

Compliance officers and business leaders

Individuals responsible for accessibility programs should understand that meaningful alternative descriptions are commonly cited as an essential accessibility practice, while recognizing that alt text alone does not guarantee overall accessibility, conformance, or legal compliance. For questions about specific legal obligations, consult qualified legal counsel and current agency guidance.

Inside Alternative Description

Text Alternative

A textual equivalent that conveys the purpose or content of non-text elements such as images, icons, or controls, enabling assistive technologies to present the information to users who cannot perceive the visual content.

Alt Attribute (alt text)

The HTML attribute commonly used to provide a short text alternative for an image. This is the most familiar mechanism for supplying an alternative description on the web, though it is one of several available techniques.

Decorative vs. Informative Distinction

A determination of whether an element conveys meaning or is purely decorative. Informative elements generally need a descriptive alternative, while decorative elements are commonly given an empty text alternative so assistive technology can skip them.

Context-Dependent Content

The appropriate description often depends on the surrounding context and the function the element serves. The same image may warrant different alternative text depending on whether it acts as a link, a button, or standalone content.

Long Description Mechanisms

For complex visuals such as charts or diagrams, a brief alternative may be supplemented by a longer description provided nearby or through associated techniques, so that detailed information is not lost.

Relationship to WCAG

Providing text alternatives for non-text content is addressed by WCAG success criteria under the Perceivable principle. Level A includes the foundational requirement to provide text alternatives for non-text content.

Common questions

Answers to the questions practitioners most commonly ask about Alternative Description.

Is an alternative description the same as a caption or a visible label?

No. An alternative description is text that conveys the purpose or content of non-text content (such as an image) to users who cannot perceive it visually, and it is often provided programmatically rather than displayed on screen. A caption is generally visible text associated with an element, and captions in the media context refer to synchronized text for audio. These serve different purposes and should not be treated as interchangeable.

Does adding an alternative description to every image automatically make a page accessible or WCAG conformant?

No. Providing alternative descriptions addresses one aspect of accessibility related to non-text content, but conformance depends on many other factors, and meeting individual success criteria does not guarantee a fully accessible experience. Automated tools can detect missing descriptions but generally cannot judge whether the description is accurate or meaningful, so manual review and testing with assistive technology are commonly needed. This is not legal advice.

How should I decide what an alternative description should say?

The description should generally convey the function or meaning of the content in its context rather than simply listing what is visually present. The same image may warrant different descriptions depending on how it is used. When an image is purely decorative, it is common practice to mark it so that assistive technology can ignore it rather than announcing an unhelpful description.

What is the difference between a short alternative description and a longer description?

A short alternative description commonly provides a concise equivalent suitable for most images, while a longer description may be used when the content is complex, such as a chart or diagram, and cannot be adequately summarized briefly. The appropriate choice depends on how much information the user needs to understand the content's purpose in context.

How are alternative descriptions handled for decorative or redundant images?

When an image is decorative or duplicates adjacent text, it is generally recommended to provide an empty or null alternative so that assistive technology can skip it. This helps avoid presenting users with redundant or distracting information. The decision depends on whether the image adds meaning beyond what is already available in text.

How can I verify that alternative descriptions are effective?

Because automated checks typically identify only whether a description is present, not whether it is meaningful, effective verification generally involves manual review and testing with assistive technologies such as screen readers. Reviewing descriptions in the context in which the content appears helps confirm that they convey the intended purpose to users who cannot perceive the non-text content.

Common misconceptions

Every image must have descriptive alt text.

Not all images require a description. Purely decorative images are commonly given an empty text alternative so that assistive technology skips them; adding descriptions to decorative elements can create unnecessary noise for screen reader users.

An automated tool can reliably generate correct alternative descriptions.

Automated checks can detect whether an alternative is present but generally cannot judge whether it is accurate, meaningful, or contextually appropriate. Human review is typically needed to confirm the description conveys the intended purpose.

Providing alt text guarantees WCAG conformance or legal compliance.

Supplying a text alternative addresses specific success criteria but does not by itself ensure overall conformance, an accessible experience, or immunity from legal claims. Manual and assistive technology testing across the full experience remain necessary, and this guidance is not legal advice.

Best practices

Write alternative descriptions that convey the purpose or function of the element in its context, rather than simply naming the file or repeating nearby visible text.

Mark purely decorative images with an empty text alternative so assistive technology can skip them, and reserve descriptions for content that conveys meaning.

Adjust descriptions based on how an element is used, providing action-oriented text when an image serves as a link or button and content-oriented text when it stands alone.

For complex visuals such as charts and diagrams, supplement a concise alternative with a longer description available nearby or through an associated technique.

Verify alternative descriptions through manual review and testing with screen readers, since automated tools can confirm presence but generally cannot judge accuracy or relevance.

Keep descriptions concise and free of redundant phrasing such as 'image of', and review them when surrounding content or the element's function changes.