· Updated
How to create a step-by-step guide with screenshots
Turn a repeatable task into a clear screenshot guide: capture the useful steps, write direct instructions, review private details, and keep it current.
Start with the manual method. You can do the whole thing today with the screenshot tool already on your machine, and knowing how long it takes by hand is the only way to tell whether a tool is saving you anything.
The job has four parts: capture, caption, redact, and maintain. The last one is where guides actually fail.
Before you capture: do the thing once
Run the whole workflow start to finish without recording anything.
A dry run reveals the steps your reader will need. You will discover that step 3 requires a permission you forgot about, that there is a modal you always dismiss without reading, and that the “obvious” route is actually two clicks longer than the one you use out of habit. If you capture on your first pass you will capture all of that, and then spend longer deleting it than the dry run would have taken.
While you do it, decide three things:
- Where the guide starts. Not “log in” — assume the reader is where they’d realistically be. A guide to exporting a report starts on the reports page, not the login screen.
- Where it ends. The last screenshot should show the outcome, not the last click. The reader needs to recognise success.
- The one path. If there are two ways to do it, pick the one that works for everyone, not the one that’s fastest for you. Keyboard shortcuts are a footnote, not a step.
Capture
Set your window to a fixed size and leave it alone. This is the single biggest quality difference between a guide that looks made and one that looks thrown together. If every screenshot is a different width, the reader’s eye has to re-orient on every image. Pick a size — 1440 wide is a reasonable default — and do not resize, zoom, or move the window until you are finished.
Capture the region, not the screen. A full-screen capture on a modern monitor produces an
image where the relevant button is 2% of the pixels. Capture the application window, or a
consistent region within it. On Windows, Win + Shift + S gives you a region snip. On macOS,
Cmd + Shift + 4 does, and Cmd + Shift + 4 then space captures a single window cleanly.
Capture before the click, not after. The reader needs to see the button they are about to press, in the state it is in when they need to find it. A screenshot of the result belongs to the next step.
Keep the cursor in shot if your tool allows it. A visible cursor over the target element does more to orient a reader than an arrow you draw on afterwards. Windows’ Snipping Tool does not include the cursor; a screen recorder does, which is one reason recording and extracting frames often beats snipping.
Capture the important transitions. A missing result or intermediate screen can make the instructions confusing. Keep the window size consistent if you need to capture another step.
Caption
Here is the rule that fixes most bad guides: the caption says what to do, the screenshot says where.
Write the instruction so it works with the image missing. Then let the image answer “which one?” and “what does it look like?”
Bad:
Click here.
Also bad, in the opposite direction:
Click the blue “Export” button in the top right corner of the Reports page, underneath the date filter and next to the Share icon.
Good:
Click Export.
The screenshot already establishes that it is blue and in the top right. Repeating the visual information in words is what makes documentation exhausting to read, and it is also what breaks first when your UI changes — the button moves, and now the text is wrong as well as the image.
Three more caption rules:
- One action per step. “Click Export and choose CSV” is two steps. Split it. A reader who fails will fail on one of them, and you want to know which.
- Name what they’ll see next when it isn’t obvious. “Click Export. A format picker opens.” saves the reader wondering whether it worked.
- Bold the thing they click. It makes the guide scannable, and most people scan.
Number your steps. Not because it is prettier, but because it lets someone say “I’m stuck on step 4” — which is the entire point of writing the guide.
Redact
Do this before the guide leaves your machine, and treat it as part of capture rather than polish.
Anything you record from a real account is likely to contain: customer or colleague names, email addresses, revenue or usage figures, account IDs, API keys, an internal URL structure you would rather not publish, and a browser tab bar that says more about your company than you think.
Cover, don’t crop, when position matters. If you crop out the sidebar, the reader loses the spatial context that helps them find the button. Blur or block the sensitive area instead and leave the layout intact.
Keep secrets out of the capture. Use representative data when possible. For selected private content, check whether the redaction tool changes the image or only adds an overlay, and inspect the final result. Blur can reduce distraction; it does not establish that the original detail is gone.
Never redact by drawing over the image in a tool that keeps layers. If you export a PDF or a layered file with a black rectangle on top, the text underneath is still there. Flatten it, or export to PNG.
Check the edges. The three places sensitive data survives redaction: the browser tab title, autocomplete dropdowns that appeared while you were typing, and notification toasts that popped up mid-capture.
If you are documenting a real customer’s account rather than your own, use a demo account instead. It is faster than redacting well, and there is no version of “I redacted it carefully” that survives a mistake.
Assemble
For a written guide, the structure that works is boringly consistent:
- A title that describes the outcome, not the feature. “How to export a report as CSV”, not “The Export menu”.
- One line on who this is for and what they need — permissions, a prerequisite, an app version.
- Numbered steps. Image, then caption underneath it, consistently. Do not alternate.
- A final screenshot of the result.
- The two or three things that commonly go wrong, at the bottom. This section is where a guide stops generating tickets.
Put it wherever your readers already are — help centre, Notion, a README, an email. A guide in the right place at half the quality beats a beautiful one nobody finds.
Maintain
Every screenshot guide starts rotting the day you publish it, and this is the part nobody plans for.
Three habits that help:
- Date it visibly. “Last checked: August 2026” tells a reader whether to trust a screenshot that doesn’t match their screen. It costs nothing and prevents a support ticket.
- Keep the source. Whatever you captured with, keep the originals in a known place. The common failure is needing to change step 4 and having to re-capture all twelve because the window size is lost.
- Note the dependency. If your guide documents a UI, whoever changes that UI should know the guide exists. A line in the help-centre article listing which screens it depends on is cruder than a real system and works better than nothing.
The rot problem is the strongest argument for using a tool rather than a folder of PNGs. Not because capture is hard — it isn’t — but because editing one step out of twelve without redoing the other eleven is genuinely tedious by hand.
When a tool is worth it
Move off the manual method when one of these is true:
- You make guides repeatedly. Compare the capture and update work with your manual process.
- Your UI changes often. Test replacing one step while keeping the rest of the guide.
- You need it to be interactive. A guide people read and a demo people click through are different formats — see interactive demo vs video vs GIF for which one your job needs.
- Several people write documentation. Test whether shared editing and conventions help the team keep guides consistent.
Two categories to choose between. Tools like Scribe and Tango produce a written guide much like the one described above, automatically. For clickable walkthroughs, evaluate Supademo or Storylane. Arcade offers a separate interactive-demo product alongside its AI video product; confirm which one fits your deliverable.
Two things to check on the pricing page before you commit, because both bite later:
- Is redaction included on the plan you are buying? Check the vendor’s current pricing page for the controls you need. If your recordings contain private information, a plan without those controls may not fit the job.
- How does it bill per person? Documentation is written by whoever knows the workflow, which is rarely one designated person. Per-seat pricing quietly decides that only one of you writes guides. We put the cost evaluation in a separate post with a worksheet for comparing your required plan and current commercial terms.
Where Demonstratio fits
Demonstratio is in development for clickable browser walkthroughs. Use an available tool for a guide you need to publish this week.
It is aimed at the rot problem, because that is the part of the manual method that does not get easier with practice. When a step has a usable captured page, you can change its text or replace an image using a URL instead of recapturing that screen. The editor includes blur and redaction tools for hiding selected content in the published walkthrough and video. Review every step and the exported file separately. Page-content edits do not appear in the screenshot-based video export, and hiding selected content does not remove the original workspace capture.
A walkthrough can split into different paths and rejoin, so readers can follow the route that fits their task. Author-added Contents entries also let viewers jump to named steps inside the player. The limits: the output is a clickable walkthrough or an MP4 rather than a written page you can export to PDF or Markdown. A video follows one path, and a step added as a plain uploaded screenshot has no page copy behind it, so its captured text cannot be edited. If your guides are reference material people scan for step 7, Scribe is still the better format and this is the wrong category.
Prices and plan inclusions are not set yet. Sign up before launch and you keep early pricing when plans go live.
Frequently asked questions
How do I create step-by-step instructions with screenshots?
Complete the task once, then capture each meaningful action. Put the screenshots in order, write one clear instruction per step, and hide private information. Test the finished guide with someone unfamiliar with the task.
Can I create step-by-step instructions with screenshots for free?
Yes. Use your computer’s screenshot tool and a document editor. Number the steps and place each instruction under its screenshot. A capture tool becomes useful when you make guides regularly or need to update them often.
Related
- Scribe alternatives in 2026 — choose between written guides, clickable demos, and video
- How to blur sensitive data in a product demo — the longer version of the redaction section
- What interactive demo software really costs
Make your next explanation a walkthrough
Demonstratio is in development. Capture a browser workflow, edit the useful steps, and share a clickable demo. Prices are not set yet. Sign up before launch and you keep early pricing when plans go live.
More guides for your next demo
How to reduce support tickets with step-by-step guides
Learn how to turn repetitive support questions into clear, visual step-by-step guides that customers can follow before they open a ticket.
How to make an interactive product demo: a simple browser-first workflow
Make a clear interactive product demo without a production team: choose one outcome, record one clean path, edit the essentials, protect private data, and share it.
Interactive demo, video, GIF, or screenshots: choose the format for the job
Help someone explore a product, find an instruction, or understand a motion. Compare interactive demos, video, GIFs, and screenshot guides.