Editorial team ·
Write the alt text that helps in this particular spot
On a venue page, a photo shows a ramp beside the front steps. A visitor trying to find the entrance could use that detail. On the same page, a wavy divider between sections adds nothing to the directions. Before you write, ask what someone would miss if the image did not load.
Start with what the person needs to know
For the entrance photo, an example description is “Ramp to the entrance, to the left of the front steps.” That detail helps when someone arrives. A general phrase such as “Photo of venue” gives them much less to work with.
For a decorative divider rendered as an image, an empty alt attribute can keep the screen reader from reading a filename. If the same image becomes the only content of a link, check the role again. The link needs an accessible name that explains where it goes.
A chart with several values may need more space than a short image description can hold. Give the chart a concise name and include the important comparison or data in nearby text or a table.
Read the result with the surrounding paragraph. If the paragraph already includes every relevant fact, repeating it may make navigation slower. Keep the image’s purpose visible in the text you decide to add.
| Image | What it contributes | Example treatment |
|---|---|---|
| Entrance photo | Locates the ramp | Ramp to the entrance, to the left of the front steps |
| Wavy divider | Decoration | Empty alt text on the image |
| Attendance chart | Shows a monthly pattern | Short chart name and a nearby table with the values |
Read the image description with the nearby text
- Identify the image’s job
- Check whether it adds information or acts as a control.
- Decide which detail someone needs for the task.
- Read the screen without seeing the image
- Listen to the image and the surrounding text in order.
- Check the names of any linked images separately.
Questions and answers
- Must every image have a spoken description?
- Supply the appropriate text alternative for what the image does. Decorative images can use an empty alt attribute.
- Should I put every chart value in alt text?
- Use nearby text or a table when the details would be difficult to hear in one long description.
- Can two copies of a photo have different alt text?
- Yes, when the photo serves different purposes in the two contexts.