Planning & site building · Practical guide

Review image alternatives across a website

Match image text alternatives to the role each image plays in its surrounding content rather than applying one caption rule to every asset.

2 min read4 practical steps

An original planning guide. Use the linked primary documentation for platform details and the supported procedure for your environment.

Classify the image's purpose

Identify informative, functional, decorative, complex, and text-containing images in their actual page context.

Write the needed equivalent

Describe information or function that would otherwise be missing. For purely decorative images, use the appropriate empty alternative.

Review neighboring content

Avoid unnecessarily repeating an adjacent heading or caption. Provide a longer text explanation for complex information when a short alternative cannot convey it.

Check implementation

Inspect the rendered markup and review the reading experience with appropriate tools. Verify linked images and image buttons have a useful accessible purpose.

Worked scenario

See the plan in practice.

A magnifying-glass button performs search, so its accessible name should explain the action instead of merely describing the shape.

Review your result

Your acceptance checklist

  • Purpose classified
  • Alternatives useful
  • Markup checked

Use these checks to identify gaps in your image-alternative review. Assign an owner to any unresolved item before the next dependent step.

Primary references

For the underlying concepts and current platform details:

Continue your project

More planning & site building guides.

All planning & site building guides

Frequently asked questions

What you need to know.

Talk to our team

What will I produce when I review image alternatives across a website?

The intended deliverable is an image-alternative review.

Match image text alternatives to the role each image plays in its surrounding content rather than applying one caption rule to every asset.

Where should I start reviewing image alternatives?

Classify the image's purpose. Identify informative, functional, decorative, complex, and text-containing images in their actual page context.

Write the needed equivalent. Describe information or function that would otherwise be missing. For purely decorative images, use the appropriate empty alternative.

How can I review the completed image-alternative review?

Check your image-alternative review against these acceptance points:

  • Purpose classified
  • Alternatives useful
  • Markup checked

Inspect the rendered markup and review the reading experience with appropriate tools. Verify linked images and image buttons have a useful accessible purpose.

Let.com

Coming soon.

Account sign-up, log-in and checkout are not available yet. You can explore our products and compare plans while we get everything ready.

Compare plans