Write useful image alt text.

Describe the information an image adds in context, then review the result where visitors will encounter it.

Follow the steps.

Use your own accurate details and check the result as you go. You can return to the relevant Website editor to make corrections.

  1. Identify the image's job

    Decide whether the image explains a project detail, person, place, product, or another meaningful subject.

  2. Describe the information

    Write a concise description for someone who cannot see the image in the Page or entry context.

  3. Check the presentation

    Review the image, Alt text, and optional Caption in the supported Page or content placement.

Illustrative example

What a useful result looks like

The result
A description of the meaningful detail the image adds in that context.
What to check
Read the text without the image and remove irrelevant keywords or repeated captions.

Adapt the example to your Website and review the result before moving to the next task.

Describe meaning, not metadata

Alt text should explain the visual information that matters in context. A filename or keyword list is not a useful description.

Use captions for extra context

A caption can add context for everyone; keep it separate from alternative text when both fields are available.

Before you continue

Alt text improves the description of an image; it does not make an image accessible in every context, repair a poor crop, or replace permission to publish it.

Make the next change with a clear result in mind.