What goes in a video tutorial script?
| Section | What to say | What to show |
|---|---|---|
| 1. Result first | What the viewer will be able to do by the end, in one sentence. | The finished result: the shared page, the exported file, the working setting. |
| 2. Before you start | What they need: the plan, the permission, the file. Skip if nothing. | The screen where they would check it. |
| 3. Steps | One action per step. Say where to click as you click it: "Open Settings, then Sharing." | A screen recording of exactly that action, zoomed on the part that matters. |
| 4. Common snag | The one place people get stuck, and how to get past it. | The error or wrong setting, then the fix. |
| 5. Recap | The steps again, one short line each. | A checklist on screen, or the finished result again. |
| 6. Next step | One thing to do or watch next. | End card with the link or the next video. |
The difference from an ad or a launch video: a tutorial viewer already wants the thing; they need the steps in order, named the way they appear on screen. For a sales-shaped video use the six-beat video script template or the explainer video script structure instead.
Sample video tutorial script: sharing a collection (2 minutes)
An illustrative example for a made-up product, Pinbook, a bookmark manager. Each row is one shot of the screen recording, with its word count against the budget for that many seconds at 150 words per minute.
| Time | On screen | Voiceover |
|---|---|---|
| 0:00–0:0819 / 20 words | A Pinbook collection called "Trip ideas" open in a browser, with a share link copied. | In this video you'll share a Pinbook collection, so anyone with the link can see it or edit it. |
| 0:08–0:1617 / 20 words | The account menu, showing the plan name. | You can share from any plan. To let other people edit, they need a free Pinbook account. |
| 0:16–0:3432 / 45 words | Cursor opens the sidebar and clicks the collection. Zoom on the three-dot menu, then "Share". | Open the collection you want to share. In the top right, click the three dots, then Share. A panel opens with two options: anyone with the link, or only people you invite. |
| 0:34–0:5432 / 50 words | The "Anyone with the link" toggle switches on. A link appears; the cursor clicks Copy. | For a read-only link, turn on Anyone with the link and click Copy. Paste that link anywhere, in a message, a doc or an email. People can open it without signing in. |
| 0:54–1:1629 / 55 words | Cursor types an email address into "Invite people", picks "Can edit" from the menu, clicks Send. | To work on it together, type their email under Invite people, choose Can edit, and click Send. They get an email, and the collection shows up in their sidebar. |
| 1:16–1:3221 / 40 words | The invite shows "Pending". Zoom on the Resend link. | If someone says they never got the invite, check the spelling of the email, then click Resend. It's usually a typo. |
| 1:32–1:4619 / 35 words | A three-line checklist on screen: Share, Copy link, Invite to edit. | So: open the collection, click Share, then copy the link to show it, or invite people to edit it. |
| 1:46–2:0013 / 35 words | End card: "Next: organise a collection with tags" and the video link. | Next, see how to organise a collection with tags. It's linked right here. |
182 spoken words, about 1:13 of voiceover at 150 wpm in a 2:00 video, so about 0:47 is screen action with no speech. Counted from the voiceover column on this page.
What makes it work: the finished link is on screen in the first second, every step names the button exactly as it is labelled, the one common snag gets its own row, and the recap repeats the steps in a single sentence.
How many words is a tutorial script of each length?
| Length | Slow (130 wpm) | Average (150 wpm) | Fast (160 wpm) |
|---|---|---|---|
| 1 minute | 130 words | 150 words | 160 words |
| 2 minutes | 260 words | 300 words | 320 words |
| 3 minutes | 390 words | 450 words | 480 words |
| 5 minutes | 650 words | 750 words | 800 words |
| 10 minutes | 1,300 words | 1,500 words | 1,600 words |
Words = minutes × words per minute, for continuous speech. Instructors in 862 online lecture videos averaged 156 wpm (Guo, Kim and Rubin, 2014); Descript recommends 150 to 160 for explainer voiceovers (Descript). A screen-recording tutorial has pauses while things load and the cursor moves, so treat these as ceilings. Time a draft in the script length calculator, or convert any number with words to minutes.
How do you write a video tutorial script?
- Write down the end result. One sentence: what the viewer can do after watching. If it takes two, make two videos.
- Do the task yourself, slowly. Note every click and every screen. Those notes are your step list.
- Cut to one action per step. Merge anything trivial and split anything with two actions.
- Write what you will say over each action. Name the button or menu as it appears on screen, in the same words.
- Add the result first and a recap last. Show the finished result in the first seconds so viewers know they are in the right place.
- Read it aloud against the recording. Every step needs time for the action, so cut words where the screen does the explaining.
Recording it yourself? Load the voiceover into the free online teleprompter and read it at about 150 words per minute while you work through the steps, or record the voiceover separately and lay it over the screen recording.
Is a tutorial script different from a video ad script?
Yes. An ad script has to earn attention in the first seconds and lands on one call to action; a tutorial assumes the viewer chose to watch and wants every step. Ads are 15 to 60 seconds and count words per beat; tutorials run as long as the task. For ad formats with examples, see commercial script examples; for a launch video, the launch video script generator builds a timed draft from your answers. A tutorial is also a good companion to a product demo video: the demo sells, the tutorial teaches.
