A documentary script is the narration for a true story, plus notes on what the viewer sees while they hear it.
Below is an example with lines from one of my own scripts, a template you can copy, and the six rules I use. I've written 10,000+ YouTube scripts across 100+ niches, many of them documentary-style.
What a documentary script looks like
Film and TV use two columns: picture on one side, sound on the other.
For YouTube I use one column. The narration is written as normal lines. The visual goes in square brackets next to the line it belongs to. Four markers cover almost everything:
- [B-ROLL] footage that plays under the narration
- [CLIP] archive footage or a recorded quote
- [TEXT] a date, name or number on screen
- [HOLD] a beat of silence on one image
Written this way, the script is also the editor's shot list. They can cut the video without calling you.
Documentary script template
TITLE: [the angle, in one line] RUNTIME: [minutes] WORDS: [about 150 per minute] COLD OPEN (0:00 to 0:45) [Drop into one moment. A place, a date, a person, something wrong.] [Do not name the full story yet. Leave 3 or 4 questions open.] FIRST REVEAL (0:45 to 1:30) [Give one answer the viewer has been waiting for. Usually who or what this is.] [Say what is at stake.] ACT 1: [one-line summary] NARRATION: [what the viewer hears] [B-ROLL] [what they see while they hear it] [TEXT] [any date, name or number on screen] TURN: [the line that changes what the viewer thought was happening] ACT 2: [one-line summary] NARRATION: ... [CLIP] [archive footage or a quote] TURN: ... ACT 3: [one-line summary] NARRATION: ... [HOLD] [a beat of silence on one image] TURN: ... CLOSE (last 30 seconds) [Resolve the story. Answer the question from the cold open.] [One last fact that changes how the whole thing looks.]
Documentary script example
These lines are from a documentary-style script I wrote about the times the world almost ended. It covers 74,000 years of history.
The opening. The obvious start was the oldest event. I opened with 1918 instead:
"2020 was a bad year for viruses. We can agree on that. But potentially 1918 was slightly worse. Hear me out."
Every viewer lived through 2020. The script starts with something they remember, then uses it to walk them into something they don't.
A fact, written as a scene. The plain version is "the Toba eruption ejected about 2,800 cubic kilometres of ash." Here's the line I wrote:
"Picture this. You're doing caveman stuff. Then out of nowhere, the ground begins shaking. At first, you're annoyed because you think it's your neighbours. But it's not a nightmare. Nope. There's ash. A lot of ash. Like around 2,800 cubic kilometres of ash."
Same number. The viewer is standing in the scene when they hear it, so they remember it.
A hard idea, in everyday terms. For the Cold War, a history lecture would have lost them. The script says:
"The Cold War was two superpowers playing the most dangerous game of chicken the world has ever seen... It was like two toddlers trying to press the big shiny buttons that would wipe everyone out."
The 6 rules I write documentaries by
1. Start with what the viewer already knows
Date order is for timelines. Open with the event closest to the viewer's own life, wherever it falls in the story.
2. Open inside a moment
A place, a date, a person, something wrong. One strong true crime opening I studied starts in a meeting hall in Iraq in July 1979, where nobody in the room knows why they were called. No history of the country. No biography. Just the room.
3. Release information one piece at a time
That same script doesn't name the man in charge for the first 30 seconds, even though the thumbnail gives it away. When the name lands, the viewer feels they guessed right. Each fact should feel earned.
Most scripts do the opposite and answer every question in the first sentence. The viewer has the full picture and leaves.
4. Build the scene around the number
A statistic read out loud is forgotten. Put the viewer somewhere, then give them the number.
5. Translate hard ideas into things people have held or seen
Every historical or technical idea has a modern equivalent. Find it and lead with it. The technical explanation comes second.
6. Turn the story at the end of every section
Each section answers a question and opens a bigger one in the same breath. An answer with nothing after it is where viewers leave.
On heavy subjects, give the viewer a breath now and then. A dry line resets them so they can keep going.
How to write a documentary script, step by step
- Research. Go to primary sources: court records, old news reports, the methods section of studies. That's where the details nobody else has are.
- Pick the angle. One way into the story. Write it as a single line.
- Choose the opening moment. The one scene you'd describe to a friend first.
- List the turns. Three to five points where the viewer's understanding changes. Those are your acts.
- Write the narration. Short sentences. Say it out loud as you go.
- Add the visual markers. Every line that describes something should be specific enough for an editor to find the footage.
- Close on resolution. Answer the question you opened with. Don't recap.
The full writing process is in how to write a YouTube script in 8 steps. To size your draft, use the script length calculator.
Where documentary scripts go wrong
- They start with background. Two minutes of history before anything happens.
- They tell it in date order when the best scene is in the middle.
- They read like an encyclopedia. Nobody opens YouTube to read one.
- They end with a summary. The viewer just watched it.
More finished scripts are in five script examples with breakdowns, and the reasons viewers stay are in the retention techniques post.
If you'd like the AI you already use to write in this structure, FacelessOS is 22 skill files built from those 10,000+ scripts, with documentary and true crime formats included.
Common questions
What is the format of a documentary script?
Film and TV documentaries use two columns: what you see on one side, what you hear on the other. For YouTube, one column works better. Write the narration as normal lines and put the visual in square brackets next to the line it belongs to.
How do you start a documentary script?
Start in the middle of one moment. Give a place, a date, a person and a sign that something is wrong. Hold back the background until the viewer is asking for it.
How long is a documentary script?
Narration runs at about 150 words a minute. A 10-minute YouTube documentary is roughly 1,500 words, and a 20-minute one is roughly 3,000.
Can AI write a documentary script?
AI is useful for research and for a first draft once it has a structure to follow. Given a plain prompt it tells the story in date order and explains everything up front, which is the pattern that loses viewers.
More script formats: How to write a video essay script · Explainer video script template
Related on the blog: how i wrote a VIRAL 806k-view script for a faceless YT channel (full outlier breakdown) · A Documentary YouTube Script System: What FacelessOS Covers · Writing True Crime YouTube Scripts With FacelessOS
Get the free hook guide
5 faceless hook patterns that retain 60%+ of viewers. Plus the scriptwriting newsletter, a few emails a week when something is worth sending.
You get the guide and my newsletter, with the occasional FacelessOS offer. Join 1,000+ creators on the list. Unsubscribe any time. Privacy.
The best YouTube scriptwriting system in the world.
Built by a scriptwriter, not a prompt engineer. 22 skill files from 10,000+ scripts across 100+ niches: research, hooks, structure, a humanizer, and an audit that loops until the script passes. It runs inside the AI you already use. $799 once for Files, $1,299 for FacelessOS+. Every future version included. If your first draft isn't better than what you have now, DM @fyreinteractive and we fix your setup.
Get FacelessOS for $799