How to Include the Mouse Cursor in Mac Screenshots

Why macOS hides the cursor by default

When you press ⌘ + Shift + 3 or ⌘ + Shift + 4, macOS strips the mouse cursor from the resulting image. Apple’s logic: most screenshots are for sharing UI, not pointing at it. But there are plenty of situations where you need the cursor visible — tutorials that show where to click, documentation for hover states, UX recordings that demonstrate a user flow, or bug reports where cursor position matters.

The good news: macOS has a built-in option for this. The bad news: it’s not where most people look.

Method 1: Screenshot.app — Show Mouse Pointer option

The Screenshot toolbar (introduced in macOS Mojave) has a hidden option to include the cursor:

1. Press ⌘ + Shift + 5 to open the Screenshot toolbar.
2. Click Options in the toolbar.
3. Check Show Mouse Pointer at the bottom of the menu.
4. Take your screenshot using any of the capture modes (entire screen, selected window, or selected portion).

The cursor will now appear in every screenshot you take through the toolbar. This setting persists — once enabled, the cursor stays visible in future captures until you turn it off.

Important limitation: This option only appears when you use ⌘ + Shift + 5. The older shortcuts ⌘ + Shift + 3 and ⌘ + Shift + 4 always hide the cursor regardless of this setting. If you want cursor capture via keyboard shortcut, you need to trigger captures through the toolbar or use Method 2.

Method 2: Terminal — screencapture with cursor flag

The screencapture command-line tool has a -C flag that forces the cursor into the capture:

# Capture entire screen with cursor
screencapture -C ~/Desktop/with-cursor.png

# Capture with cursor after a 3-second delay
screencapture -C -T 3 ~/Desktop/with-cursor.png

# Interactive selection mode with cursor
screencapture -C -i ~/Desktop/with-cursor.png

# Capture a specific window with cursor
screencapture -C -w ~/Desktop/window-with-cursor.png

The -C flag works with all screencapture modes. You can combine it with -T for a timed delay (useful when you need to position the cursor over a specific element before capture), -i for interactive selection, or -w for window capture.

This is especially useful for scripting. If you’re automating screenshots for documentation or testing, the Terminal method gives you programmatic control over cursor inclusion without any GUI interaction.

Method 3: Screen recording — single-frame extraction

Screen recordings on Mac always include the cursor. You can use this as a workaround when other methods don’t work (for example, in apps that intercept screenshot shortcuts):

1. Press ⌘ + Shift + 5 and select Record Entire Screen or Record Selected Portion.
2. Position your cursor where you need it.
3. Stop the recording.
4. Open the recording in QuickTime Player.
5. Scrub to the exact frame you want.
6. Press ⌘ + C to copy the current frame, then paste it into Preview or another image editor.

This is overkill for a quick screenshot, but it’s the most reliable way to get the cursor in situations where the Screenshot toolbar option doesn’t work or the cursor disappears in certain app contexts.

Method 4: Preview — capture with cursor via menu

Preview has its own screenshot capability that includes cursor support:

1. Open Preview.
2. Go to File > Take Screenshot.
3. Choose From Entire Screen (with a timed delay) or From Selection.

When you choose From Entire Screen, Preview gives you a countdown before capturing. The cursor is included in the capture by default. The resulting image opens directly in Preview for immediate editing — crop, annotate, or export.

This method is slower than keyboard shortcuts but useful when you specifically need the cursor and don’t want to remember Terminal flags.

Which screenshot modes support cursor capture

Highlighting the cursor for tutorials and presentations

Including the cursor is step one. For tutorials and documentation, you often need to make the cursor obvious — a small arrow on a busy screen is easy to miss. Here are options for cursor highlighting:

macOS Accessibility zoom. Go to System Settings > Accessibility > Zoom and enable Enable Hover Text or increase the cursor size under System Settings > Accessibility > Display > Pointer. You can make the cursor significantly larger so it stands out in screenshots. Drag the Pointer size slider to the right before capturing.

Custom cursor color. In macOS Monterey and later, go to System Settings > Accessibility > Display > Pointer. You can change the pointer outline and fill color. A bright red or yellow cursor stands out in screenshots far better than the default black-and-white arrow.

Click visualization in screen recordings. Some third-party tools can add click ripple effects, cursor trails, or highlight circles around the cursor in recordings. If you’re creating video tutorials and extracting frames, tools like Keycastr (free, open source) show keystrokes and mouse clicks as an overlay.

Automating cursor screenshots with a Shortcut

If you frequently need cursor-inclusive screenshots, create a macOS Shortcut that wraps the Terminal command:

1. Open the Shortcuts app.
2. Create a new Shortcut.
3. Add a Run Shell Script action.
4. Enter: screencapture -C -T 2 ~/Desktop/cursor-screenshot.png
5. Assign a keyboard shortcut to the Shortcut in System Settings.

Now you have a one-key capture that always includes the cursor with a 2-second delay to position it. Adjust the -T value to change the delay, or remove it entirely for instant capture.

Troubleshooting: cursor not appearing

The cursor vanishes in certain apps. Some apps hide the system cursor and draw their own (common in games, design tools, and video editors). The -C flag and Screenshot toolbar only capture the system cursor. If the app uses a custom cursor, you may need to use screen recording instead.

The cursor appears but in the wrong position. On multi-monitor setups with different scaling (Retina + non-Retina), the cursor position in screenshots can be offset. This is a known macOS bug. Workaround: capture only the display where the cursor is located using screencapture -C -D 1 (where 1 is the display number).

Show Mouse Pointer option is greyed out. This can happen after a macOS update resets screenshot preferences. Try resetting the screenshot configuration:

defaults delete com.apple.screencapture showsCursor
killall SystemUIServer

Then reopen ⌘ + Shift + 5 and re-enable the option.

Cursor shows in full-screen capture but not in window capture. This is expected behavior. The “Show Mouse Pointer” option in the Screenshot toolbar primarily affects full-screen and region captures. For window captures (⌘ + Shift + 4, then Space), the cursor is used to select the window, so it’s excluded from the result. Use screencapture -C -w in Terminal if you need the cursor in a window capture.

When cursor screenshots matter most

Software tutorials and onboarding docs. Users need to see exactly where to click. A screenshot of a settings panel is ambiguous without the cursor pointing at the right toggle. “Click here” means nothing if “here” isn’t visible.

Bug reports involving hover states. CSS hover effects, tooltip positions, and context menus are all cursor-dependent. If you’re reporting that a tooltip appears in the wrong place, the screenshot needs to show where the cursor is relative to the trigger element.

UX testing and heatmap documentation. When documenting user flows or annotating where users click, cursor-inclusive screenshots serve as visual evidence of behavior patterns.

Accessibility audits. Documenting focus indicators and pointer targets requires showing the cursor in relation to interactive elements. This is essential for WCAG compliance documentation where you need to prove that click targets meet minimum size requirements.