Editorial guide based on official documentation; not a hands-on product test.
Write useful alt text for meaningful images, avoid redundant descriptions, and place optimized images near relevant page content.
Decide what the image contributes
Alt text should communicate the purpose or information a meaningful image adds in its current context. A product photo might need color, shape, and a distinctive detail; a process diagram may need its sequence. If the nearby caption already gives the same information, the alt text can be shorter. Decorative flourishes should have an empty alt attribute so assistive technology does not announce noise.








From the community
Join the conversation.