Images and video
Screenshots that show where the reader is, not just what to click.
By HeyThula · Updated
Press / and choose Image to upload one, or Video to embed from YouTube, Loom or Vimeo.
Images
PNG, JPEG, WebP or GIF, up to 5MB. Uploaded images are stored with your article and served from your help centre — nothing expires and nothing depends on an external host.
Show enough context
The most common mistake in a support screenshot is cropping too tightly. A close-up of three form fields proves nothing to a reader who doesn't already know which page they're on.
Include enough around the edges to answer "where am I?" — the sidebar with the active section, the page heading, the tab that's selected. Then the reader can find the screen before worrying about the control.
Write alt text
Describe what the screenshot shows. It's read aloud to anyone using a screen reader, and shown if the image fails to load.
"Settings screen" is not alt text. "The AI tab in Settings, with Answer with AI switched off" is.
Don't put words only in pictures
Anything that exists solely inside a screenshot is invisible to search, invisible to the AI, and invisible to anyone who can't see the image.
Write the instruction in text, and let the screenshot confirm it. The picture supports the words rather than replacing them.
Video
Paste a YouTube, Loom or Vimeo link and it embeds responsively. Video is good for showing a flow with lots of small steps and poor for reference — nobody scrubs a video to re-check one detail.
If you embed a video, write the steps underneath as well.
Keep them current
Screenshots age faster than prose. A single stale screenshot undermines confidence in the whole article, so when a screen changes, search your help centre for images of it.