ScenePilot

Blog · Guide

How to write a YouTube documentary script people finish

Long documentaries live or die on the script. These seven rules keep viewers watching past the first minute and all the way to the end.

28 September 20267 min read

A white Cadillac Seville labelled by a ScenePilot graphic
From Why Mechanics Feared the Cadillac Northstar V8, a ScenePilot film.

1. Open on the result

Most viewers decide whether to stay in the first thirty seconds. Don't spend them on background. Start with the most surprising true thing in your story, then promise to explain it: a Honda beat a Ferrari in a magazine test; mechanics were afraid of a Cadillac engine; a car was too advanced to survive.

The background still goes in. It just comes second, once the viewer has a reason to care about it.

Lead with what happened. Spend the rest of the video on how.

2. Write for the ear

A documentary script is heard, not read. Keep sentences short, give each one a single idea, and read every paragraph out loud before you move on. If you run out of breath, the sentence is too long.

Prefer concrete nouns to adjectives. "The V6 used four valves per cylinder" paints a picture. "It was a remarkable achievement" doesn't. Concrete lines are also far easier to put pictures to.

3. Build chapters around questions

Split the story into chapters of two to four minutes, and give each one a single question to answer. End each chapter by raising the next question. That open loop is what carries viewers across the natural drop-off points of a long video.

Good chapter questions are specific: not "the history of the company" but "why did they build the body from aluminium when nobody else could?"

4. Keep the stakes human

Machines, companies and battles are more gripping when someone has something to lose. Find the engineer who bet their career on a design, the rival who underestimated it, the decision that could have gone the other way. Viewers follow people through a story, even when the story is about a car.

5. Make numbers felt

A number on its own is forgettable. A number next to something the viewer already knows lands: not just "270 horsepower", but "270 horsepower, from an engine smaller than the Ferrari's". Compare, round where precision doesn't matter, and use one number per point rather than three.

6. Hit the right length

Narration runs at about 150 words a minute. A 20-minute documentary is roughly 3,000 to 3,300 words; 15 minutes is about 2,300. Write to the story rather than the clock, then trim anything that doesn't move it forward. If you're unsure how long to go, we wrote a separate guide on how long a YouTube documentary should be.

7. Pay off the promise

The ending has one job: answer the question you raised in the first thirty seconds, clearly. Then give the viewer one short look forward: what happened next, or why it still matters. Skip the long recap. Anyone who watched to the end remembers the story.

A checklist before you record

Turn your script into a film

Paste it into ScenePilot and get back a finished documentary you can edit.

Start your first film