Add alternative text to images

Follow these steps

1. 1

   Open accessibility fields

   PropertiesAccessible publishing

   Select the image and click Accessible publishing in Properties. Find Alternative text in the popover. The relevant Preflight finding may also open this field through its inline-fix action.

2. 2

   Write a meaningful description

   PropertiesAccessible publishing

   Describe the purpose briefly and concretely, for example Walnut-finish wardrobe with three doors. A filename, the word image, or a URL is not an adequate description. Include distinguishing details only when they are actually present.

3. 3

   Mark decoration deliberately

   PropertiesAccessible publishing

   Enable Decorative image only when the image is decoration that adds no information. Screen readers skip it. The stored description is kept and becomes available again when you remove the decorative flag.

   Do not mark a meaningful product photo or diagram decorative just to dismiss a finding.

4. 4

   Update the description after changes

   EditorCanvas

   Review the description when replacing the photo, cropping an important detail, or changing its content with AI. Make sure the old wording still describes the new result.

5. 5

   Check findings and reading

   EditorPreflight

   Review missing or uninformative-description findings. A clean automated check does not prove that the meaning is correct; read the text in the accessible version and compare it with the page’s purpose. For images inside shapes or paths, also follow the masking lesson.

Related lessons

• Convert an SVG image to editable vectors
• Images
• Producing an accessible publication