How to Create a Step-by-Step Guide from Clicks on Mac

A step-by-step guide built from clicks follows the same order the task really takes. Each click becomes one screenshot and one step, so the guide matches what the reader will do.

This post covers the general method, then the exact workflow with Temposhot Action Capture on a Mac.

Choose one task for the guide

Pick a single task with a clear start and finish: "Invite a teammate", "Export last month's invoices", "Change the default printer". A guide that covers two tasks forces the reader to search for the part they need.

Write the finished result in one sentence before you start. That sentence becomes the guide title and the check on the last page.

Prepare the screen for capture

Captured screens show everything that is visible. A few minutes of setup saves editing later.

• Close unrelated apps, windows and browser tabs.
• Turn on a macOS Focus mode so notifications do not appear.
• Sign in with a test account that holds sample data.
• Set the app window to the size readers are likely to use.
• Start from the screen where the reader starts, not halfway through.

Do one practice run without recording. Finding the right menu during the real run adds stray clicks to the guide.

Capture one screenshot for each meaningful click

The useful screenshot shows the screen just before the click, with the control still visible and unpressed. That is the moment the reader needs to match on their own screen.

Not every click is meaningful. Clicks to focus a window, dismiss a tooltip or scroll a list add pages without adding steps. Plan to delete those pages, or skip them during recording.

Mark where each click happened

A screenshot without a mark leaves the reader to guess which of thirty controls matters. A cursor or a highlight on the clicked area answers that at a glance.

Keep marks consistent across the guide: same shape, same color, same size. Readers learn the pattern on the first page and scan faster after that.

Review the screenshots in order

Read the pages from top to bottom as if you had never done the task. Look for:

• Pages from accidental or duplicate clicks.
• A missing screen, such as a dialog that appeared without a click.
• Steps where the screenshot does not show the control named in the title.
• Personal data in sidebars, headers or notifications.

Delete, reorder or recapture pages until each one shows exactly one action.

Add annotations where the click marker is not enough

Click markers show where. Some steps also need what: the value to type, the option to choose, or a warning. Add a short text label next to the target, or an arrow when the control is small. Put longer explanations in the step description rather than on the image.

Export and check the finished guide

Export to the format your readers use: a PDF for email, print and offline reading, or image files for a wiki or help center. Open the export and read it once at the final size. Text that is clear on a large display can be too small on a printed page.

Create the guide with Temposhot Action Capture

1. Configure titles and marks

   Press Command+3 and open Configure. Turn on Parse clicked elements. The default title template is Click "[[element-name]]", and clicks without a readable name get Click here. Under Visual Annotations, turn on Show cursor on click captures and Mark clicked area.

2. Start Action Capture

   Select Start Action Capture. In Choose Capture Target, pick Active Window, Full Screen, Specific Window or Capture Area.

3. Perform the task

   Click through the task. Each accepted click saves the target as it looked just before the click. Clicks that come too close together are ignored, which avoids duplicate steps from one interaction.

4. Add steps without a click

   Press Shift+Command+2 or select Capture now in the floating toolbar for screens such as a confirmation message or a hover state.

5. Pause and finish

   Select Pause capture to stop accepting clicks, and Resume capture to continue. Select Finish capture at the end. The Document opens in the editor.

In the editor, the Pages panel lists one page per step. Edit each Page title and description in the Page Inspector. Press F for Framing and choose Focus on action with a level from Wide to Tight. Add Text (T) or Arrow (A) where needed. Blur (B), Click Marker (M) and Step Numbers (N) are Pro tools.

Select Export PDF or open More export formats for PNG, JPG or WebP pages and a ZIP package with document.json. With Pro, the PDF dialog adds a cover page, step numbers, page numbers and description placement.

How much text Parse clicked elements can read depends on the accessibility information the target app provides. The Action Capture guide and the editor guide cover each setting.

FAQ

What happens if I click the wrong thing during recording?

The click becomes a page. Delete it in the Pages panel after you finish, or select Pause capture before exploring and resume when you are back on track.

Is there a limit on the number of steps?

Without Pro, a run pauses when it reaches the free step limit. Steps already captured stay saved. Select Open document to finish, or Continue with Pro after activating a license.

Does Action Capture record video?

No. It saves one still screenshot per accepted click or manual capture. For the trade-offs, see step-by-step screenshot guide vs screen recording.

Does it work in any Mac app?

Capturing works in apps that allow screen capture. Automatic titles depend on each app's accessibility metadata, and apps that block screen capture cannot be recorded.

Turn your clicks into a clear step-by-step guide

Action Capture turns one pass through a task into an ordered, marked and editable guide. Download Temposhot for Apple Silicon Macs on macOS 14 or later.