What Is Alternative Text?
Alternative text, commonly called alt text, is a short text description that communicates the purpose or important information of an image to people who cannot see it. Screen readers can read alt text aloud, helping people who are blind or have low vision understand the content and purpose of an image.
Good alt text depends on the image and the context in which it is being used.
Where Do I Put Alternative Text?
In Drupal:
- When inserting or editing an image, look for the Alternative Text field.
- Enter the appropriate alt text for the image.
Updating Alternative Text for an Existing Image
- Navigate to the image in the Media section.
- Select Edit.
- Add or update the text in the Alt Text field.
- Save your changes.
How to Write Good Alternative Text
- Describe the purpose: Consider why the image is on the page and what information someone would miss if they could not see it.
- Be concise: Include the important information without unnecessary visual details.
- Be contextual: Alt text should reflect how the image is being used on the page. The same image may need different alt text in different contexts.
- Avoid unnecessary phrases: You usually don't need to begin alt text with “image of,” “picture of,” or “photo of.” Screen readers typically identify the content as an image.
- Don't repeat nearby text: If the same information is already provided in surrounding text, avoid unnecessarily repeating it in the alt text.
Examples
Too vague:
“C²¹³¾±è³ܲõ”
Better:
“Students walking across the Westfield State campus green”
Too detailed:
“Students walking across the Westfield State campus green on a sunny afternoon with seven trees, several chairs, a blue sky, and Ely Hall visible on the left”
Include those additional details only if they are important to understanding the purpose of the image.
Remember
The goal of alt text isn't to describe every visual detail. Ask yourself:
“What information or purpose would someone miss if they couldn't see this image?”
Use your answer to create clear, concise, and meaningful alt text.