Writing & StyleStyle guide

Writing Text Alternatives for Functional Images

Writing Text Alternatives for Functional Images is purpose-specific accessibility guidance for interactive images and stays separate from the broader figure-alt-text owner.

Quick answer

For a functional image used as a link or button, write the text alternative to communicate the action or destination, not merely the image’s appearance.

Key details

Core IssueW3C WAI says the text alternative for a functional image should convey the action or purpose rather than describe the visual image.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers images that initiate actions; informative and decorative images require different text-alternative decisions.

Further guidance

Content

Name the function or destination the image activates, such as search, print, or a homepage destination.

Purpose

Users need the same functional meaning even when the image itself is not perceived.

Sources and evidence

Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.

  1. Functional Images — W3C WAI Images Tutorial (opens in a new tab)World Wide Web Consortium (W3C) · W3C WAI guidance that text alternatives for functional images communicate the action or purpose rather than visual appearance.

Related guides

Writing & Style

Writing Text Alternatives for Groups of Images

Writing Text Alternatives for Groups of Images records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Writing & Style

Writing Text Alternatives for Images of Text

Writing Text Alternatives for Images of Text records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Writing & Style

Writing Text Alternatives for Informative Images

Writing Text Alternatives for Informative Images records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Explore the topic