Best practices for including images

Images clarify complex UI or workflows in technical documentation. They should supplement, not replace, written content and include alternative text for accessibility.

Use a screenshot, diagram, or GIF to clarify a process or accompany conceptual information. Use an inline image if a UI element is unclear. For details on when to include and avoid using images, see the following guidance:

All images must supplement written content. Don't use an image as a replacement for writing out a process or a concept. Images must also include surrounding and alternative text to assist users with visual impairments. If you include an optional title for an image, do not enumerate the title because the number loses context if the image is reused.