
A screenshot can show a setting, example or result that would take several sentences to describe. A useful caption tells readers why the screenshot is there and where to look.
Identify the view in plain language
Give readers enough context to recognize what is on screen. “The export dialog with the file type menu open” is more useful than “Screenshot of the process.” If the layout differs by platform, mention which version or device the example shows when that affects the instruction.
Point to a detail and explain its purpose
Name the visible label rather than relying only on a colored arrow. For example, “In the export dialog, check the File type field before saving so the recipient gets the format they requested.” The caption still makes sense when the image is narrow or the annotation is hard to see.
Keep essential instructions in the article
Put each required action in the main text so readers can follow the procedure with images disabled. Use the caption to orient sighted readers and the alt text to describe visual information they would otherwise miss. Read the paragraph, alt text and caption together to catch unnecessary repetition.
Review the image before submission
Check for email addresses, private project names, open tabs and other information that may have slipped into the capture. Use a demo account or a recreated example where possible. Send the editor the final image and caption together, and use the guest post revision brief guide to record any remaining requests.