How to Annotate Screenshots for Clear Instructions on Mac

An instruction screenshot has one job: show the reader where to act. Annotation makes that location obvious. Too many marks hide it again, so every arrow, box and label on a page should answer one question about the step.

This guide covers what to mark, which tool fits each job, and how to annotate pages in the Temposhot Documents editor on a Mac.

Start with one point of attention

Before you draw anything, write the step in one sentence. "Select Export in the toolbar" tells you the target is the Export button and the context is the toolbar. Everything else on the screen is background.

Use that sentence to sort the screen into three parts:

• The target. The single control the reader acts on. It gets the strongest mark.
• The context. Enough surrounding interface for the reader to find the target on their own screen. A toolbar, a sidebar or a dialog title is usually enough.
• The noise. Other windows, unrelated panels, personal data. Crop it or cover it.

If one screenshot needs two targets, the step probably has two actions. Split it into two pages.

Crop before adding annotations

Cropping changes where everything sits, so marks drawn first often end up misplaced or cut off. Crop first, then annotate.

In a Temposhot Document, press F for Framing. Pages recorded with Action Capture carry the click position, so Focus on action can zoom around it automatically. Pick a level from Wide, Relaxed, Balanced, Close or Tight. Wider levels keep more context. Tighter levels emphasize the exact control.

For imported images, choose Custom and drag the region. Select Apply framing. Framing does not overwrite the source image, and Show full image removes the crop at any time. The annotations and framing guide covers each control.

Choose the annotation by its job

Each annotation type communicates something different. Using them consistently across a guide teaches the reader your visual language within a few pages.

Job	Tool in Temposhot	Key
Show where to click	Click Marker (Pro)	M
Point at a small control	Arrow	A
Group a region	Rectangle or Ellipse	R or O
Separate two areas	Line	L
Explain a value	Text	T
Show order on one screen	Step Numbers (Pro)	N
Hide private details	Blur (Pro)	B
Remove distractions	Framing	F

Select, move and resize marks with the Select tool (V). The Object Inspector changes color, width, opacity and stacking order. Use [ and ] to move a mark backward or forward.

Use click markers for exact actions

A click marker says "act here" without words. It works best on buttons, menu items, checkboxes and tabs.

Action Capture can add the marker during recording. Under Configure, the Visual Annotations section offers Show cursor on click captures (Mac Pointer, Minimal Arrow, Touch Dot or Crosshair) and Mark clicked area (Circle or Rectangle, with border and background colors). These marks stay editable in the Document.

To add one by hand, press M and click the control. Keep the marker slightly larger than the control so its label stays readable through the highlight.

Use arrows and shapes for context

Arrows help when the control is small or sits in a dense toolbar. Start the arrow in empty space and end it just short of the control. An arrow that crosses text makes both harder to read.

Rectangles and ellipses group things: a panel of related fields, a status area, a column in a table. Use an outline rather than a heavy fill so the reader can still see what is inside.

Keep text short and outside the target

Text labels carry values the screenshot cannot show, such as the file name to type or the option to pick. Two to six words are enough. Longer explanations belong in the Page description, which appears with the screenshot in a PDF export.

Place labels beside the target, never on it. A label on top of a button hides the button text the reader is looking for. Use one font size for all labels in a guide.

Blur only what must be hidden

Blur (B, Pro) covers names, email addresses, account numbers and tokens. Drag it over the exact field and nothing more. A blurred area the size of half the window makes the reader wonder what they are missing.

For data that must never leave your Mac, crop it out with Framing or retake the screenshot with sample data. The browser tool Image Redaction Tool redacts a single image locally. See privacy blur for how blur differs from full removal.

Compare the screenshot before and after

Use Duplicate page from the page menu, delete the marks on the copy, and view the two pages side by side in the Pages panel. If a mark does not make the step easier to follow, delete it. Then delete the copy.

Check consistency across pages too. Copy a finished mark with Command+C and paste it on the next page with Command+V so sizes and colors match.

Check the final reading size

A label that looks fine on a large display can be unreadable on a printed A4 page or a phone. Select Export PDF and step through the live preview before you export. The export guide lists PDF, PNG, JPG and WebP pages and the ZIP package.

For one-off images outside a guide, the browser tool Screenshot Annotation Tool adds arrows, boxes and text in the browser. The file stays on your device.

Frequently Asked Questions

Do annotations change the original screenshot?

No. Annotations and framing in a Temposhot Document are non-destructive. Exports render them into new files, and the source image stays unchanged.

Which annotation tools need Pro?

Blur, Click Marker and Step Numbers are Pro tools. Text, Rectangle, Ellipse, Line, Arrow and Framing are available without a license.

How many annotations should one screenshot have?

One strong mark for the target, plus a label if the reader must enter a value. If you need more, consider splitting the step.

Can I annotate images I did not capture with Temposhot?

Yes. Create a Document from the New Document menu with Images… and annotate the imported pages the same way. See screenshot annotation for the general practice.

Turn your clicks into a clear step-by-step guide

Action Capture records one screenshot per click with the cursor and click area already marked, so most pages need little extra annotation. Download Temposhot for Apple Silicon Macs on macOS 14 or later.