Blog

How to Write a Customer-Facing Walkthrough From One Recording

Written by InSnap · Published · customer support, how-to guide, documentation, screen recording

How to Write a Customer-Facing Walkthrough From One Recording

Record the task once, then turn it into a guide a customer can follow: which steps to keep, what to hide, and how to export it.

Support desks, onboarding teams and account managers spend a surprising amount of time writing the same instructions twice: once as a reply, once as a document nobody finds later. Recording the task once and turning the recording into a guide removes that duplication.

The workflow below assumes InSnap's guide recorder, which captures a screenshot on every click and turns each one into a step. The structure — record, prune, label, redact, export — works with any tool that does the same thing.

Record the task, not the explanation

Start the guide recording, then do the task at normal speed. Do not narrate to the screen and do not open a document to read from; the recording is raw material, not the finished article.

Two habits make the result much easier to edit:

  • Use the real screen. Record in the customer's context, not a mocked-up demo, so the screenshots match what the person will see.
  • Do the task in order. Every click becomes a step in the sequence it happened, which is the order a reader needs.

Stop recording when the task is done. Everything after that point is editing, which is faster than recording more.

Prune before you write a single word

A recorded guide always contains noise: the sign-in step, the search that missed, the window dragged into place. Cut those first, because writing titles for steps you are about to delete is wasted effort.

  • Drag steps to reorder them.
  • Delete steps that do not teach anything.
  • Hide a step that matters for context but would distract, rather than deleting it.

A sixteen-step recording usually becomes eight or nine steps. That is the right outcome, not a sign you recorded badly.

RECORDING A TASK INTO STEPS

Write titles people can scan

Default titles come from the control that was clicked, which is a good starting point and a poor final answer. "Save button" tells a reader nothing about why they are saving.

Rewrite each title as an instruction:

DefaultBetter
SaveSave the draft before changing permissions
SettingsOpen Account & license
ClickEnter the activation code from your email

Conversely, the note under each step should explain the part nobody can see in a screenshot: what happens next, what a value should be, what to do if the button is greyed out.

Editing titles and notes

Redact before the guide leaves your machine

Customer guides are where privacy mistakes happen. A support recording of a real account contains real names, real email addresses and often a real order number. Once that PDF is in a customer's inbox, or on a shared drive, it is out.

InSnap has a one-click answer: draw a mosaic over the sensitive area on one step, then click Blur in all steps. The mosaic is copied to every step at the same relative position, scaled to each step's image size.

Check every step afterwards. If the page scrolled between clicks, the same row has moved, and the copied mosaic will sit over empty space while the data stays visible. Fix those steps individually.

BLURRING THE SAME AREA ACROSS EVERY STEP

Add the structure a reader needs

A wall of steps is intimidating. Group the task so a reader can tell where they are:

  • Sub-steps for the small actions inside one idea — expanding a menu, then choosing an entry.
  • Callouts for the thing that is easy to get wrong. Use a warning for data loss, a note for context.
  • A cover page with a title, the date, and who wrote it.

Then export in the format the reader will actually open. For a customer, that is usually PDF. For an internal runbook, Markdown in the repository. For a training deck, PowerPoint.

Adding sub-steps and callouts

Send the guide, not the recording

A recording has to be watched; a guide can be skimmed and searched. When the goal is "the customer should be able to do this on their own", the guide is the better artefact — and the screenshots make it usable on a phone support call, where watching a video is not practical.

Keep the recording if the task involves motion — dragging, animation, a sequence that is clearer moving. Otherwise the guide replaces it.

FAQ

Can I record a guide and edit it later?

Yes. The guide editor keeps the recorded steps and their screenshots, so titles, notes, order, hidden steps and mosaics can all be changed after recording. The original screenshots are never overwritten.

How do I stop a customer's data appearing in the guide?

Redact before exporting. Draw a mosaic on one step and use Blur in all steps, then check each step — especially ones captured after the page scrolled — and fix any placement that has drifted.

Which export format should I send a customer?

PDF for customers and anyone outside the company. HTML for a self-hosted help page, Markdown for a repository, Word or PowerPoint for training material. All formats contain the same steps and images.

Is a recorded guide better than a written one?

For anything that happens on screen, yes — the screenshot removes the ambiguity of "click the button on the right". Written instructions are still better for policy, background and anything that is not a click.

Your next screenshot is one hotkey away.

macOS 14.4+ (Apple Silicon & Intel) · Windows 10+ (64-bit)