MainspringGuides › Screenshots for bug reports
macOS Guide

Save lighter screenshots for bug reports on Mac

Updated July 2026 · 4 min read

File a bug and you rarely attach one screenshot — you attach five: the error, the console, the settings, the before, the after. As PNGs that's a heavy upload and an attachment quota you'll hit fast. Saving screenshots as JPG keeps each one light without losing what a reviewer needs to see. Here's the setup for a QA workflow.

Make JPG the default for repeat captures

When you're capturing all day, the format adds up. Switch the default to JPG once and every screenshot you take for a ticket is already lighter:

# Save screenshots as JPG
defaults write com.apple.screencapture type jpg
killall SystemUIServer

# Undo — back to PNG when you need lossless
defaults write com.apple.screencapture type png
killall SystemUIServer

Five JPGs on a ticket weigh less than one full-screen PNG often did. The setting holds across macOS 13 Ventura, 14 Sonoma, and 15 Sequoia.

Keep the evidence readable

JPG's compression softens fine, high-contrast detail — which is exactly what a wall of small console text is. For screenshots a developer has to read, protect legibility:

The rule of thumb: JPG for UI and screens, PNG for anything text-heavy a reviewer will zoom into.

Corral them into a ticket folder

A pile of shots on the desktop is easy to mix up between tickets. Point screenshots at a dedicated folder so each batch stays together — how to change the screenshot save location on Mac covers the toolbar and Terminal routes.

Paste straight into the tracker

Often the lightest workflow skips files altogether. Add Control to any screenshot shortcut — Shift+Ctrl+Cmd+4 — and the capture goes to the clipboard instead of a file. Then paste it directly into a Jira comment, a GitHub issue, or a Slack message; the tracker handles the image and you never create, name, or attach a file. See how to copy a screenshot to the clipboard on Mac.

Lighter tickets, one toggle

Mainspring turns screenshots-as-JPG into a labelled toggle you can flip on for a QA session and off when you need lossless logs — one of 90+ reversible macOS settings, no Terminal.

Try Mainspring free →

Signed & notarized by Apple · 1-day free trial · $29 once

One window, cleanly captured

Most bug shots are of a single window. How to screenshot a window on Mac keeps them tightly framed and free of surrounding clutter.