Skip to content

Script template

Documentary Script Template

A documentary script is an investigation built on sourced facts and driven by one clear question. The viewer stays because they need the answer, not because you are telling them a story in order. Every scene must introduce new evidence or complicate what came before.

Most scripts in this format fail because they become timelines. They list dates and events instead of building a case. A good documentary script reads like a detective walking you through a room, pointing at specific objects, and explaining why each one changes the picture.

By Founder @ Hookquill · Updated

When this format fits

  • You have a central mystery or question that requires multiple pieces of evidence to answer.
  • The topic involves real people, companies, or events where sourced facts carry the weight.
  • You want to explain how a complex situation unfolded without relying on your personal opinion.
  • The story has a clear turning point or complication that shifts the narrative direction.
  • Do not use this format if your goal is simply to teach a process step by step or share a personal vlog update.

The template, section by section

  1. 1.Cold open

    7% of runtime

    Drop the viewer into the single most striking moment or contradiction in the entire story.

    Start with a concrete detail from your sources, like a date, a quote, or a sudden shift in numbers. Do not greet the audience or announce the video topic. The first sentence must be under fifteen words and prove the viewer clicked the right video.

    On a Tuesday morning in March, a channel about mechanical keyboards posted a video that broke its own record by a factor of ten.

  2. 2.The question

    6% of runtime

    State the central mystery the video will investigate so the viewer knows exactly what they are waiting to find out.

    Name the gap between what should have happened and what actually happened. Keep it narrow enough that the viewer believes you can answer it in the runtime. This is your main open loop, so do not resolve it until the final third of the script.

    How did a niche that took three years to build an audience get completely flooded in less than two months?

  3. 3.Context

    12% of runtime

    Give the viewer only the background facts they absolutely need to understand the evidence coming next.

    Cut any history that does not directly set up the acts. Introduce the key players, the platform, or the market conditions using specific nouns. If a fact does not make the later evidence hit harder, leave it out.

    For years, the mechanical keyboard community on YouTube was small enough that creators recognized each other by their audio setups.

  4. 4.Act One

    20% of runtime

    Present the first major piece of evidence or the initial phase of the event that sets the story in motion.

    Anchor this act in a specific source, like a filing, an interview, or a data point. End the section by revealing a complication that makes the initial evidence insufficient. That complication becomes the bridge into the next act.

    According to social tracking archives, search volume for custom keyboard builds doubled between January and February of that year.

  5. 5.Act Two

    20% of runtime

    Introduce the complication, the competing force, or the unexpected turn that deepens the investigation.

    This is where the timeline usually traps writers, so focus on cause and effect rather than sequence. Show how the new evidence contradicts or complicates what you established in Act One. Attribute every claim clearly to your sources.

    But the search volume was not coming from hobbyists anymore, because three large tech channels had published beginner guides in the same week.

  6. 6.Act Three

    20% of runtime

    Deliver the final piece of evidence that forces a resolution to the central question.

    Bring the investigation to its peak by showing the consequence of the complication. Use the most concrete visual details here, as this act carries the heaviest narrative weight. Leave no major threads from earlier acts unaddressed.

    Within thirty days, the original creator's videos were buried under hundreds of uploads using the exact same thumbnail framing.

  7. 7.The answer

    10% of runtime

    Resolve the central question explicitly using the accumulated evidence from the previous acts.

    State the conclusion plainly without adding new mysteries. Tie the final answer back to the specific anomaly or question you raised in the cold open. Let the facts do the work instead of editorializing the outcome.

    The niche did not die from bad content, but from a sudden wave of algorithmic arbitrage that made the barrier to entry vanish overnight.

  8. 8.Implication

    5% of runtime

    Show why this specific resolution matters beyond the immediate story without delivering a moral lesson.

    Point to a broader pattern or a concrete next step that follows logically from the answer. Keep it brief and grounded in reality. Avoid summarizing the video or telling the viewer what they should have learned.

    Now, every micro niche on the platform operates on a timer, waiting for the day the wider algorithm notices it exists.

Timing guide

Word counts assume a conversational pace of about 150 words a minute. Check your own pace before you trust them.
Timing guide
RuntimeWordsNotes
5 min750Merge Context into Act One. Cut Implication down to a single closing sentence. You only have room for two acts, so pick the two strongest pieces of evidence and drop the rest.
8 min1,200This is the baseline length where all sections breathe. Expand Act Two to include a second complication. Give Context enough room to introduce two distinct sources or characters.
12 min1,800Add a fourth act between Act Three and The Answer. Use the extra time to explore a counterargument or a false lead the investigation had to rule out. Expand the Cold Open slightly to build more atmosphere.
20 min3,000Treat each act as a mini documentary with its own setup and payoff. You can afford a longer Context section, but still keep it under fifteen percent. Rehook aggressively every ninety seconds by introducing a new document, interview clip, or data point.

A full documentary script

Example script · documentary · about 6 minutes · 783 words

How one small channel's niche became crowded almost overnight

Cold open

Drop the viewer into the single most striking moment or contradiction in the entire story.

A custom keyboard channel hit a wall it never expected.

For three years, the creator uploaded weekly builds to an audience of a few thousand dedicated hobbyists. Views were steady. Comments read like a group chat. Then, over a single weekend, the channel's most popular video was outranked in search results by dozens of uploads from accounts created just days earlier.

The thumbnails looked identical. The titles used the exact same keywords. But the voices behind them were strangers.

The question

State the central mystery the video will investigate so the viewer knows exactly what they are waiting to find out.

How does a hyper specific corner of YouTube go from a quiet workshop to a crowded factory floor almost overnight?

The answer is not about one viral video. It is about a structural shift that left the original builders entirely exposed.

Context

Give the viewer only the background facts they absolutely need to understand the evidence coming next.

To see how this happened, you have to look at how the mechanical keyboard space operated before the shift. It was a niche built on expensive parts and long wait times. Viewers watched these videos to learn about switch lubrication or soldering techniques, not for quick entertainment.

Because the barrier to entry was high, the creator pool stayed small. Channels knew each other. They linked to each other's builds. Growth was measured in dozens of subscribers a month, not thousands.

Your story here: A specific moment when you noticed a niche you followed suddenly felt different (What was the exact video or moment you realized the space had changed?)

That stability relied on one assumption. The assumption was that making these videos required specialized knowledge that could not be easily faked.

Act One

Present the first major piece of evidence or the initial phase of the event that sets the story in motion.

The first sign of trouble was not a flood of new channels. It was a change in search behavior.

According to archived trend data, search interest for budget mechanical keyboards spiked sharply right before the larger channels arrived. People were no longer searching for custom builds. They were searching for cheap alternatives they could buy immediately.

This shift mattered because it changed who the algorithm wanted to serve. The audience was no longer just hobbyists willing to spend hours learning a craft. It was now general consumers looking for a quick buying guide.

The original small channels were still making tutorials. But the demand had moved to product reviews. That gap between what the old creators made and what the new searchers wanted was the opening.

Act Two

Introduce the complication, the competing force, or the unexpected turn that deepens the investigation.

Once that gap opened, larger channels noticed it.

A handful of broad tech creators published beginner guides to mechanical keyboards within weeks of each other. They did not have the specialized knowledge of the niche veterans. But they had massive existing audiences and professional production teams.

These videos immediately captured the top search positions. The smaller channels lost their discovery traffic almost instantly.

But the big channels were only the first wave. The real crowding happened because of what those large videos signaled to the rest of the platform.

When a broad tech channel gets millions of views on a keyboard video, it proves to everyone else that the topic has mainstream appeal. The niche was no longer hidden. It was validated.

Act Three

Deliver the final piece of evidence that forces a resolution to the central question.

Validation triggered automation.

Following the success of those broad tech videos, networks of newly created channels began uploading daily. They used the exact same thumbnail compositions that the large channels had proven worked. They targeted the same high volume keywords.

The original creator's archive was suddenly buried under hundreds of nearly identical videos. These new uploads did not need to be better. They only needed to be newer and optimized for the exact terms the algorithm was currently rewarding.

Your story here: A specific instance where you saw a creator struggle against a sudden wave of copycat content (Have you seen a creator in your space get buried by this kind of wave, and what did they try to do about it?)

The small channel had spent three years building trust with a specific community. But the algorithm was no longer sorting by trust. It was sorting by recency and click through rate on a topic that had just gone mainstream.

The answer

Resolve the central question explicitly using the accumulated evidence from the previous acts.

The niche did not get crowded because the original creator did something wrong. It got crowded because the audience's intent changed, and larger players proved that change was profitable.

The shift from specialized tutorials to broad buying guides lowered the barrier to entry to zero. Once that barrier fell, automated networks filled the space faster than any individual creator could upload.

The quiet workshop became a factory floor because the blueprint was finally easy enough for anyone to copy.

Implication

Show why this specific resolution matters beyond the immediate story without delivering a moral lesson.

This pattern is not limited to keyboards. Any micro niche on the platform operates on a similar timer. It remains quiet only until the broader algorithm decides the topic has mass appeal. Once that happens, the original builders have to compete on a playing field they never designed.

Where this format goes wrong

  1. 1.Writing a timeline instead of an investigation. Scripts often fall into a pattern like "In 2019 this happened, then in 2020 this happened."

    Structure your acts around questions and evidence. Each section should answer one question while raising a harder one for the next act. Replace chronological transitions with causal ones.

  2. 2.Stating conclusions that the provided sources do not support. A line like "Everyone knew the company was lying" sounds dramatic but destroys credibility.

    Attribute every claim. Say "the internal emails released in the filing show" or "according to the former employee's testimony." If you lack a source, write around the gap.

  3. 3.Burying the most interesting fact in the middle of the script. Writers often save their best evidence for Act Three, causing viewers to leave early.

    Put the most striking true thing in the cold open. You do not have to explain it fully yet, but you must show it. Tease the deeper context for later acts so the viewer stays.

  4. 4.Using fake drama phrases to transition between sections. Lines like "But things were about to get worse" signal that the script lacks actual evidence.

    Rehook with a concrete detail from the next section. Instead of vague suspense, say "The next filing revealed a number that contradicted everything the CEO had just said."

  5. 5.Summarizing the entire video in the final thirty seconds. Recaps kill retention at the end because the viewer already watched the video.

    Use the implication section to point forward. State one concrete way the resolution of this story affects the broader landscape or the viewer's future actions. Keep it under fifty words.

Questions

How many sources do I need for a short documentary?

You need enough sources to support every factual claim you make without guessing. For a five minute video, three to five distinct primary sources like documents, interviews, or verified data points are usually enough. If you find yourself writing a paragraph without a source to anchor it, cut the paragraph or find the evidence.

Can I use my own experience as evidence in this format?

Only if your experience is documented and verifiable as part of the investigation. This format relies on external facts, not personal anecdotes. If you must include a personal moment to ground the story, use a designated story marker so you remember to verify the details before recording.

What if my sources contradict each other?

Contradictions are excellent material for a documentary because they create natural tension. Present both claims clearly, attribute them to their specific sources, and let the viewer see the conflict. Your job is to investigate the discrepancy in the next act, not to hide it.

How do I keep the pacing fast when dealing with heavy research?

Limit your context section to only the facts required to understand the very first piece of evidence. Do not explain the entire history of the topic upfront. Introduce background details inside the acts exactly when they become relevant to the evidence you are presenting.