"The button is kind of off to the right and the text overlaps a bit on smaller screens."
That sentence took thirty seconds to write and loses most of what matters. A screenshot takes two seconds and loses nothing. If your AI assistant accepts images, sending one is often the fastest way to a fix. Here's how to do it well.
What screenshots are good for
- Error screens and stack traces. Especially from a terminal, a CI log or a mobile device where copying text is painful.
- Layout bugs. Misalignment, overflow, overlapping elements, wrong spacing.
- Diagrams and whiteboards. Turn a photo of a sketch into a schema, a task list or starter code.
- Charts and dashboards. "Why does this graph spike at 3 a.m.?" works better with the graph attached.
The one sentence that matters more than the image
A screenshot shows what happened. It doesn't show what you wanted. Always add one line:
Expected: the button stays inside the card on screens under 400px.
Without it, the model has to guess which of the six odd things in the picture is the bug.
Send the code too, when there is code
For a layout bug, the image shows the symptom and the CSS holds the cause. Send both:
- the screenshot;
- the component or stylesheet that renders it;
- the expected result.
Crop, but not too much
Crop out other tabs and unrelated windows. Keep the browser width visible for responsive bugs, and keep the full error with a few lines above it. The line before the error is often the real one.
Check what's in the frame
Before you send a screenshot anywhere, look for API keys in the terminal, customer data in the table, and tokens in the address bar. Blur or crop them. This applies to any tool, AI or not.
When text is still better
If you can copy the error as text, paste the text and add the screenshot only if layout matters. Text is exact; a model reading small or blurry characters from an image can misread one.
What's the strangest thing you've debugged from a screenshot?
Disclosure: I work on MadGPT, where image input works in every model except Coder. The advice above applies to any assistant that accepts images. Drafted with AI assistance, edited by a human.
Top comments (0)