Not long ago we wrote a 10-minute script for a YouTube channel that covers royal families. The subject was a government reshuffle in Brunei, which on paper is about as gripping as a tax form. The video passed 84,000 views, about five times the channel’s average. I want to walk through how that script was built, step by step, because most guides to YouTube scripts treat every video the same way, and a documentary asks for something different.
A documentary has to hold someone for ten minutes or more with true events and no tricks. That puts nearly all the weight on structure. So alongside our own script, I went looking for what YouTube’s documentation and some solid research say about attention, curiosity and stories. Quite a lot of it turned out to be useful.
Find the question inside the topic
A topic is something you could look up. Brunei’s Sultan made his son Foreign Minister: that’s a topic, and a news site covers it in three paragraphs. The question hiding inside it is what makes a documentary. This Sultan had held almost every top job in his government for close to six decades, then gave one away just weeks before turning 80. Why now?
That question became the title, the hook and the thread through the whole script. The idea behind it goes back to a well-known 1994 review by the economist George Loewenstein at Carnegie Mellon. His information-gap theory describes curiosity as “arising when attention becomes focused on a gap in one’s knowledge.” He also points out that “people are not always curious, even though they are surrounded by vast regions of ignorance.” That line explains a lot of flat videos. A viewer doesn’t feel the gap until you point at it.
Before writing a word of narration, I’d write the question in one sentence. NPR’s training team gives the same advice to radio reporters in its guide to writing for radio: “If you can’t summarize what the story is about in a single sentence, you’re headed for trouble.”
Use the opening to keep a promise
YouTube measures the opening of a video on its own. Its help page on audience retention explains that the “Intro” figure in YouTube Studio shows “what percentage of your audience still watched your video after the first 30 seconds.” When that number is high, YouTube’s reading is that “the content in the first 30 seconds matched the viewer’s expectation of the video’s thumbnail and title.” A separate page on how the recommendation system sees your content says it plainly: “Ensure your intro delivers on the promise made by your thumbnail and title.”
So the hook is less about grabbing attention and more about confirming the viewer clicked the right thing. Here is how our script opens:
Brunei’s Sultan just gave Prince Mateen real power. He appointed him Foreign Minister. [PAUSE] But you would be surprised to know… for nearly sixty years, this man kept almost every important decision in his own hands.
The first line pays off the title right away. The second adds the contrast that makes it strange. Then comes one human detail (the prince is better known for his polo horses and three million Instagram followers), and the hook closes on the title’s question, word for word: “But why now?” The request to subscribe comes after that, at about the one-minute mark. Asking for a favor before you’ve given anything is a hard sell, in videos and in life.
Build acts that hand off to each other
After the hook, the script runs in six parts, each with a plain title and a time:
- The birthday the world watched (1:00 to 2:30)
- The six months nobody talks about (2:30 to 3:30)
- The day he gave power away (3:30 to 6:00)
- The heir who keeps waiting (6:00 to 7:30)
- Three wives, one family (7:30 to 9:00)
- Ending (9:00 to 10:05)
The important part is the seams. Every act ends by opening a smaller question that the next act answers. The first one closes with “to understand why he did it this year, you have to look at what happened to him six months earlier.” Viewers who would drift at a natural pause get a fresh reason to stay.
There’s research suggesting those small open questions do more than hold attention. In a 2009 brain-imaging study in Psychological Science, a team that included Loewenstein found that curiosity activated reward-related regions of the brain, and that higher curiosity was linked to better memory of surprising answers one to two weeks later. A viewer who wanted the answer is more likely to remember it, and to remember where they heard it.
Acts also matter because attention runs in shorter stretches than video does. A study of 6.9 million viewing sessions on the edX course platform, by Philip Guo and colleagues at MIT and edX in 2014, found that median engagement time was “at most 6 minutes, regardless of total video length.” Those were lecture videos, not documentaries, so I wouldn’t read it as a rule for YouTube. The lesson I take from it is that a ten-minute video needs several fresh starts, and acts give you those.
Acts also turn neatly into YouTube chapters. According to YouTube’s help page on chapters, you add timestamps to the description, starting at 00:00, with at least three in ascending order, and each chapter has to be at least 10 seconds long. If your script already has titled acts with times, the chapter list is done.
Write for the ear
A documentary script is read aloud by a narrator and heard once by the viewer, who can’t reread a sentence that tangled. The NPR guide puts the rule simply: “Use short sentences. We speak with simpler syntax than we write with.” It also suggests reading the story aloud as you go, because a line “may sound good in your head but stumble over your lips.”
In our script, most lines carry one fact and get their own paragraph. Delivery cues sit in brackets for the narrator: [PAUSE], [LONG PAUSE], [WHISPER], [ENERGY UP]. Some are more specific, such as “CALM, let it land,” placed right before a short line that needs room. My favorite example comes from the second act. The palace had announced knee surgery for the Sultan, and the medical team included a senior heart specialist flown in from Malaysia. The script then says only this: “A cardiologist… for a knee.” Nothing more is needed, and the pause before it does half the work.
Those energy cues exist for a reason. In the same edX study, engagement tended to rise with the speaker’s pace, but the authors noted that speaking rate was “merely a surface feature that correlates with enthusiasm.” The speakers in the middle of the speed range came across as the least energetic. For a narrator, that suggests varying the pace on purpose: quick and warm in some places, slow and quiet in others. A cue in the script is how the writer asks for it.
Source every line, and say what you don’t know
A good story lowers people’s guard, and that puts a real duty on the writer. In a classic set of experiments, the psychologists Melanie Green and Timothy Brock studied what they called transportation, or “absorption into a story”. Readers who were deeply absorbed “found fewer false notes in a story” than readers who weren’t, and labeling a story as fact or fiction made little difference to how it shaped their beliefs. If your documentary works, viewers will question it less. That’s exactly why every claim needs to hold up.
Our script links each factual line to its source inside the document: wire reports, national newspapers, official statements and think-tank analysis. The editor and the client can check any sentence in seconds. Where the story moves from fact to interpretation, the wording says so: “many observers believe,” “some observers see similarities.” In the fourth act, about the Crown Prince, the script includes the line “There is no public indication that he is being replaced.” It would have been easy to imply a palace drama. Saying what the record shows kept the video fair, and I think it also made the real tension more believable.
Answer the question you opened
The ending goes back to “why now?” and gives two answers. One is simple: the Sultan had surgery, missed ceremonies for the first time and wants his sons ready. The other comes from looking at what he kept, which was the government, the army and the money. The closing line holds both: “The family looks ready for the future. And the Sultan still runs the present.”
Then it hands the question to the audience and asks which answer they believe. That turns the comments into a continuation of the video. Leaving the main question open with no answer at all would feel like a trick, and it would cost the trust the rest of the script had earned.
A checklist for your first draft
If you’re writing a documentary script this week, these are the steps in the order I’d take them:
- Write the one-sentence question your video answers. Put it in the title.
- Draft a hook of about a minute that delivers on the title in its first line, adds the surprising contrast and ends on the question.
- Plan four to six acts with plain titles and rough times. Give each one a last line that opens the next.
- Write one idea per line, then add delivery cues where the narrator should slow down, pause or lift the energy.
- Link every factual line to a source, and mark interpretation as interpretation.
- Write an ending that answers the opening question, then asks the viewer what they think.
- Read the whole script aloud with a timer, and cut anything you stumble over.
The full Brunei script, with every cue and every source link, is on our site. You can read the first minute and request the rest. And if you’d like a script like it for your own channel, that’s part of our writing work.
