How to take clear, annotated screenshots on a Mac for guides and bug reports

A good screenshot answers a question before anyone asks it. A bad one makes the reader hunt for the problem. The difference is rarely the capture itself: it is what you add afterwards. This guide walks through a simple workflow with WyzeSnap, from the shortcut to the finished image.

1. Capture only what is needed

Crop in your head before you capture. A region shot of the relevant panel is easier to read than a full screen with a tiny detail in the corner.

• Region: ⌥⇧4, then drag over the area.
• Whole screen: ⌥⇧3.
• A single window: ⌥⇧5, then pick the window from the list.

These are WyzeSnap's defaults, and you can change them in Settings. If a combination you choose is reserved by macOS or already taken by another app, WyzeSnap tells you.

Need a menu or a tooltip in the shot? Set a delay before the capture, open the menu, and wait for the timer.

2. Check the permission once

The first time, macOS asks for the Screen Recording permission, which it requires for any app that captures the screen. Open System Settings > Privacy & Security > Screen Recording, switch WyzeSnap on and relaunch the app. Without it, nothing can be captured.

3. Point at what matters

Each capture opens in the editor and is also copied to the clipboard, so you can paste it straight away if it needs no changes. To annotate:

• Rectangle or ellipse to frame the area that matters.
• Arrow to point at one thing. Hold Shift for a perfectly straight or 45° line.
• Highlighter to emphasise a line of text without hiding it.
• Text for a short label. Keep it to a few words.

Use one colour for the main point and keep everything else quiet. Three red marks on a screenshot mean nothing; one means look here.

4. Number the steps

For a how-to, use the numbered step tool and click where each action happens: 1, 2, 3. If you delete a step, the next one you add takes the lowest free number, so the sequence stays tidy. Then describe each number in your text instead of putting long sentences on the image.

5. Hide what must stay private

Before sharing a screenshot, check it for names, email addresses, tokens, account numbers and faces. Hide them with the blur tool, which offers blur or pixelation with an adjustable strength.

A few honest rules:

• Use a strong setting. Light pixelation on short or simple text can sometimes be guessed. For passwords, keys and account numbers, cover the area completely with a filled rectangle instead.
• Check the result. Zoom in on the edited area before you share.
• The original is kept. WyzeSnap never changes the original image: your annotations and blur are saved separately so they stay editable. That means the library on your Mac holds the unblurred original. Share the exported image, not the library files.

6. Export and share

Copy the annotated image to the clipboard to paste it into an email, a chat or a ticket, or save it as PNG or JPEG. Use PNG for screenshots with text, as it keeps the edges sharp.

7. Come back later

Every capture is saved in the library with its annotations, newest first. Reopen one weeks later, move an arrow, fix a label or crop it, and export it again. That makes it practical to keep one screenshot up to date for a guide instead of starting over.

A quick checklist

1. Capture only the relevant area.
2. Frame or point at the one thing that matters.
3. Number steps instead of writing on the image.
4. Hide private details, and check the result.
5. Export as PNG and share the exported file.

WyzeSnap handles still screenshots only, with no video recording, and it keeps everything on your Mac: no account, nothing uploaded.