HomeBlog › Process
Process

How to Write Work Instructions (With a Template and Examples)

TL;DR
  • A work instruction answers one question for one person: how do I do this exact task, step by step?
  • It is narrower than an SOP. The SOP is the whole process; the work instruction is one task inside it, in close-up.
  • Write one action per step, show the screen wherever the reader has to find something, and mark every decision point.
  • The instruction that nobody can find or update is already dead. Give it an owner and a review trigger on day one.

A teammate of mine once inherited a task called "run the weekly billing export." The whole handover was a sentence in a leaving email: "the billing export is easy, you just pull it from the dashboard and send it to finance." On Friday she opened the dashboard. There were four exports. Three date-range options. A toggle she didn't recognize. She sent the wrong file, finance reconciled against bad numbers, and it took two people half a day to undo.

The task really was easy. The instruction was not. "Pull it from the dashboard" assumes you already know which export, which range, and which toggle. That gap between "I know how to do this" and "I can write down how to do this" is where work instructions live, and it's where most of them fall apart.

Here's how to write a work instruction that gets a real person through a real task without a single follow-up question.

Work instructions vs SOPs: the difference that trips people up

People use "SOP" and "work instruction" as if they're the same thing, then argue about which template to use. The distinction is simpler than the debate suggests, and once you see it the writing gets easier.

An SOP describes a whole standardized process. It covers the why, the who, the when, and the rough shape of the steps. A work instruction zooms into one task inside that process and answers a single question: how do I do this, exactly? The SOP is the map of the trip. The work instruction is the turn-by-turn for one leg of it.

SOP: Process a customer refund the whole standardized process WORK INSTRUCTION Issue the refund in the billing tool (exact buttons) WORK INSTRUCTION Log it in the helpdesk (which fields, which tag) WORK INSTRUCTION Email the customer (which template, what to confirm)
One SOP, three work instructions. The SOP sets the process; each instruction handles one task in close-up.

Why does this matter for writing? Because the two documents fail in opposite ways. SOPs fail when they're too vague to act on. Work instructions fail when they zoom out and start explaining policy instead of clicks. If you find yourself writing "the purpose of this procedure is to ensure compliance with" in a work instruction, stop. That's SOP language. The reader of a work instruction is mid-task, hands on the keyboard, and they want the next click, not the mission statement.

If you're building the higher-level document too, our guide on how to write an SOP people follow covers the process side. This post stays at the task level.

How to write a work instruction, step by step

Six moves. None of them are complicated. The discipline is in not skipping the boring ones.

1. Name one task and one reader

A work instruction covers exactly one task. "Run the weekly billing export," not "manage billing." If your title needs an "and," you're describing two instructions. Then picture the person who'll read it on their worst day: the new hire in week one, covering for someone on leave, with the clock running. Write for them. Everything you'd skip because "they'll obviously know that" is the thing they don't know.

2. List what they need before they start

Nothing kills momentum like getting three steps in and discovering you need an access level you don't have. Put the prerequisites up top: the tools, the logins, the file, the permission. A reader should be able to glance at the header and know whether they can finish this right now or need to go ask for access first.

3. Write one action per step, starting with a verb

This is the rule that does the most work. "Open," "select," "click," "confirm." One action, one step. The reader should be able to do a step, look up at their screen, look back, and instantly find their place. The moment a step contains two actions joined by "and," a beginner loses the thread between them.

Before: one clumped step "Go to the dashboard and export the billing data and send it to finance." Which dashboard? Which export? Which date range? Three guesses, three ways to get it wrong. After: one action per step 1. Open the Billing tab. 2. Select last week's range. 3. Click Export as CSV. 4. Email the file to finance. One action each. Nothing left to guess.
Splitting a clumped step into single actions removes the guesses where people go wrong.

4. Show the screen

For any task done in software, a picture beats a paragraph at the exact moment it matters: when the reader has to find something. "Click the export button" is fine until there are three buttons that could be it. An annotated screenshot with the right one circled ends the hunt. This is the part most people skip, because capturing, cropping, annotating, and then re-capturing every time the interface shifts is genuinely tedious. Our guide to screenshots in documentation goes deep on doing it cleanly. If the task is software-based and you're writing the instruction from scratch, mark where each image goes before you start, so you don't talk yourself out of adding them later.

5. Mark the decisions and the "done" signal

Real tasks fork. "If the export is over 10,000 rows, split it by month first. Otherwise, send the single file." Call those out plainly, because the moment someone has to decide and the instruction stays silent is the moment they guess. And end with how the reader knows they succeeded: "Finance replies to confirm they received it" or "the status shows Reconciled." Without a finish line, people either stop early or keep poking at a task that's already done.

6. Test it on someone who has never done it

Hand the draft to a person who doesn't know the task. Watch them work through it. Don't help, don't hint, don't fill in the gap when they hesitate. Every pause is a place your instruction is broken. You can't catch these yourself, because you already know the answer and your eyes skip the hole. This one test finds more problems than re-reading your own draft ten times.

Common mistake: Writing from memory at your desk instead of while doing the task. Memory smooths over the fiddly bits — the extra confirmation dialog, the setting you change so often you forget it's a step. Write the instruction while you actually perform the task, or capture yourself doing it, so the small steps don't vanish.

A copy-paste work instruction template

Steal this. Fill in the brackets, delete what you don't need, and keep it tight. It works in a doc, a wiki, or a help-center article.

Work instruction: [Task name]

  • Task: [The one task this covers, in plain words. "Run the weekly billing export."]
  • Who does it: [Role, not a person's name.]
  • When: [The trigger. "Every Friday before noon," or "when a refund is approved."]
  • Before you start, you need: [Access, tools, logins, or files required.]
  • Time: [Roughly how long this takes.]

Steps

  1. [Verb + one action.] (Add a screenshot here.)
  2. [Verb + one action.]
  3. Decision: If [condition], then [do this]. Otherwise, [do that].
  4. [Verb + one action.]
  5. [Final action. How you know it worked: "The status shows Sent."]

If something goes wrong

  • [Common problem] → [What to do, or who to ask.]

Maintenance

  • Owner: [Role responsible for keeping this current.]
  • Last reviewed: [Date.]
  • Review when: [A trigger, like "the billing tool changes its export screen."]

Notice what's missing: no purpose statement three paragraphs long, no policy background, no scope-and-compliance preamble. That belongs in the SOP. The work instruction puts the steps first and the housekeeping at the bottom, where it won't slow anyone down.

Two work instruction examples

Templates click into place once you see them filled in. Here are two short ones from different corners of a company, both written for a first-timer.

Example 1: Issue a customer refund (support)

Work instruction: Issue a customer refund

  • Task: Refund a customer through the billing tool and close the loop.
  • Who does it: Support agent.
  • When: A refund has been approved in the ticket.
  • Before you start, you need: Billing-tool access with refund permission, the order number, the approved ticket.

Steps

  1. Open the billing tool and search the order number. (Screenshot: search bar with order number entered.)
  2. Click Refund on the order.
  3. Decision: If the refund is over $500, get a team-lead approval in the ticket first. Otherwise, continue.
  4. Select Full refund and confirm.
  5. Paste the refund ID into the ticket and reply with the "Refund processed" template. You're done when the ticket status shows Resolved.

Example 2: Reset a new hire's email password (IT)

Work instruction: Reset a new hire's email password

  • Task: Reset and re-issue an email password for a new employee.
  • Who does it: IT support.
  • When: A new hire can't log in on day one.
  • Before you start, you need: Admin access to the identity console, the new hire's employee ID.

Steps

  1. Open the identity console and search the employee ID. (Screenshot: user lookup result.)
  2. Click Reset password on their account.
  3. Select Require change at next sign-in.
  4. Decision: If the account is also locked, click Unlock before sending. Otherwise, continue.
  5. Send the temporary password through the secure channel, not plain email. You're done when the new hire confirms they're in.

Both fit on one screen. Both are written for someone who has never touched the task. Neither wastes a line on why the company has refunds or passwords. If you're documenting a stack of IT tasks like this, the patterns in our IT SOPs and runbooks guide pair well with task-level instructions.

Pro tip: Write the "If something goes wrong" line for each instruction the second time someone hits the problem, not the first. The first time, you're guessing what breaks. By the second, you know the real failure and the real fix, and you can write it in one specific sentence instead of a vague warning.

Keep them from going stale

A work instruction is only true until the tool changes. The button moves, the export screen gets a redesign, a field gets renamed, and now your carefully written steps send people in a circle. This is where most documentation dies, and it dies quietly, because nobody gets an alert when an instruction goes wrong. They just stop trusting it.

Two habits keep instructions honest. First, give every one an owner by role and a review trigger, not a vague "review annually." Tie it to the thing that actually changes: "review when the billing tool updates its export screen." Second, make the edit cheap. If fixing one outdated screenshot means re-recording the whole task and re-annotating every image by hand, it won't get fixed. The cost of the edit is the real reason instructions rot, not laziness.

That cost is the whole reason we built WriteHow. You record yourself doing the task once, and it drafts the ordered steps with annotated screenshots and any sensitive data blurred. You review and approve before anything goes live, so a person still owns the final word. When the tool changes, you re-record the affected steps instead of rebuilding the document, and you can publish the same instruction in 50+ languages without writing it five times. The point isn't to remove the human; it's to make keeping the instruction true cheap enough that it actually happens.

🎬 Record the task Do it once, out loud ✍️ AI drafts the steps Ordered, annotated, sensitive data blurred You approve Review, then publish
Record once, AI drafts, you approve. Re-recording one step is cheaper than rebuilding the whole instruction.

Start with the tasks people keep asking about. The ones that generate the most "wait, how do I do this again?" messages are the ones where a good work instruction pays for itself fastest. Write those, test them on a beginner, give them an owner, and you'll have replaced a stack of leaving-email guesses with instructions a first-timer can actually follow. That's the whole job, and it's worth doing well.

Where to go nextIT & Ops documentationWriteHow pricingWriteHow vs Scribe

Frequently asked questions

What is the difference between a work instruction and an SOP?
An SOP describes a whole standardized process and covers the why, who, and when. A work instruction zooms into one task inside that process and answers only how to do it. A refund SOP might list five stages; the work instruction for stage two tells you exactly which buttons to click to issue the refund. If you only need one document, a clear step-by-step instruction usually does both jobs.
How detailed should a work instruction be?
Detailed enough that someone who has never done the task can finish it without asking a question, and no more. One action per step, a screenshot wherever the reader has to find something on screen, and a clear signal for how they know they are done. If a step has the word 'and' in it, you probably have two steps hiding in one.
Should work instructions include screenshots?
Yes, for anything done in software. A single annotated screenshot answers 'where do I click' faster than any sentence, and it removes doubt when an interface has several similar-looking options. The catch is keeping the images current, so use a tool that makes re-capturing cheap, or your screenshots will quietly drift two redesigns out of date.
How many work instructions do I need?
One per task that someone could get wrong or do inconsistently. Start with the tasks that generate the most questions, the most rework, or the most risk when a new person takes them over. You do not need to document every keystroke in the company on day one. Write the instructions people keep asking for first, then expand.
Who should write work instructions?
The person who actually does the task, with a second person checking it by trying to follow it cold. Experts often skip the steps that feel obvious to them, which are exactly the steps a beginner trips on. Capturing the expert doing the real task, then having a teammate review and approve the draft, catches those gaps before the instruction goes live.

Skip the manual write-up

WriteHow records your task once and drafts a step-by-step work instruction — ordered steps, annotated screenshots, and 50+ languages. You review and approve before it ships.

See how WriteHow helps
AB
Aakash Bhatt · Growth Marketer at WriteHow
Writes about documentation, operations, and the small habits that keep docs honest.