Alternative Text for Images in Documents
What is alt text?
Alt text (alternative text) is a short, descriptive text that explains what an image shows. It helps users who cannot see the image - whether due to blindness, low vision, or slow internet connections. Alt text is read aloud by screen readers and appears if images fail to load. Good alt text conveys the purpose and content of images, ensuring everyone can access the information. It also helps with search engine optimization and usability.
Informative images
Informative images convey essential content or functionality that users need to understand the document. These images require descriptive alt text that explains their purpose and content. Examples include:
- Charts, graphs, and data visualizations
- Diagrams and illustrations that explain concepts
- Screenshots showing software interfaces or processes
- Maps and floor plans
- Product images in catalogs
Decorative images
If an image adds no information, mark it decorative so it’s skipped by screen readers. In authoring tools, use “Mark as decorative.” These are images used purely for visual appeal or design purposes that don't convey essential information. Unlike informative images, decorative images should be ignored by screen readers to avoid unnecessary interruptions.
Logos
Logos that serve a function (brand identification) typically should not be marked decorative in formal templates. Provide appropriate alt text describing their purpose.
How to write good alt text
- Describe essential information or function, in under ~125 characters (with spaces).
- Don’t start with “Image of …” — screen readers already announce images.
- For charts and graphs, summarize key trends or data points.
- Use plain language and avoid jargon or abbreviations unless explained.
- Alt Text References: When surrounding text/captions fully convey an image's content, alt text can be shorter and refer to more information in another location.
Adding alt text: Step-by-Step
Follow these steps to add alt text to images in your documents:
- Right-click on the image
- Choose Edit Alt Text from the context menu
-
In the Alt Text pane that appears on the right:
- Type a brief, clear description in the text box
- Keep it under 125 characters (with spaces)
- For tables/charts/graphs, summarize the key data or trend
- Focus on the image object's purpose or key information
- If the image is purely decorative, check Mark as decorative
- Click outside the pane or press Enter to save
Complex graphics and long descriptions
A long description is a more detailed text alternative that provides comprehensive information about complex images that cannot be adequately described in the limited space of alt text (which should be under 125 characters). Long descriptions are needed when charts, maps, diagrams, and infographics contain essential data, relationships, or trends that users must understand to fully comprehend the content.
Long descriptions should be used for images that convey substantial information and should be provided in the text near the image or linked from the alt text. In Microsoft 365, provide concise alt text plus a nearby detailed description in text. Ensure the long description conveys trends, comparisons, and key data points.
For tables and charts, captions can be used instead of alt text to explain the purpose or summarize a table or chart. Captions provide visible descriptions that benefit all users, not just those using assistive technology.
Common mistakes to avoid
- Alt text should never be left blank. Either select the "decorative" checkbox, or enter a description.
- Using file names or generic phrases like “image” or “graphic” as alt text.
- Failing to mark decorative images appropriately.
Check your work
- Use your authoring tool’s accessibility checker to find missing alt text.
- Review with a screen reader; ensure decorative images are skipped.
Related WCAG resources
Related WCAG resources
Success criteria
Techniques
- H37: Using alt attributes on img elements
- H67: Using null alt text and no title for decorative images
- G95: Providing short text alternatives