Videos
How to write a video brief
A video brief is five decisions written down before anyone writes a line: the goal, the audience, the one message, the assets and the format and length. Put those in a few plain sentences and a person or a generator can make the right video on the first draft instead of the third.
Indunil Asanka · Co-founder
7 min read · Published
A video brief is five decisions written down before anyone opens an editor: what the video should make someone do, who that someone is, the one thing they should remember, what material exists to show it, and the shape and length it has to fit. Everything else in a brief, tone, brand notes, the wording of the ask, hangs off those five. Get them into a few plain sentences and the first draft is usually close. Leave one out and the draft fills the gap with a guess.
The brief matters more, not less, when a generator writes the first draft. A human editor rings you with questions. A generator reads the words you gave it and builds from those.
The five things a video brief has to say
Advertising guidance keeps arriving at a short list. Google’s ABCD framework for YouTube ads sorts effective video into Attention, Branding, Connection and Direction: hook people with the story, brand early and often, help people think or feel something, and ask them to take an action. Google says following those guidelines can deliver as much as a 30 percent lift in short term sales likelihood and a 17 percent lift in long term brand contribution. Each of the four is something a brief either sets up or leaves to chance.
The published brief behind the Replyline launch video is three sentences: “Promo for Replyline’s new Saved Replies feature. Support teams answer the same question 40 times a day; saved replies cut first reply time 41 percent in beta. CTA: try it free.” Goal, audience, pain, proof and ask are all in there. The six scene, 27 second landscape video that came out of it has no scene the brief did not ask for.
Start with the goal, as one action
Write the goal as the thing a viewer does after watching, not as a feeling. “Raise awareness” gives nobody anything to aim at. “Start a free trial”, “book a table for Friday” and “use the code before Sunday” each tell the writer where the last scene is going and what every earlier scene has to earn.
One action per video. A launch video that asks people to try the feature, read the changelog and follow the company splits its closing seconds three ways and gets none of them. If there really are three actions, there are three videos, and each can be shorter for it.
The goal also decides the type of video. A promotional video sells and ends on an ask. A tutorial teaches one task and should not end on a sales line at all: the dashboard tour closes on “That’s Lumen.” after the viewer has watched an alert being set, which was the point of the whole video. Decide which of the two you are writing before anything else.
Name the audience by the moment they are in
Demographics rarely change a video. The moment the viewer is in does. “Support team leads” is a job title. “Support team leads who answer the same ticket forty times a day and suspect there is a faster way” is a moment, and it hands the writer the problem scene for free: Replyline’s second scene is the line “Same question, forty times a day.”
Write down three things about the audience: what they already know, what is annoying them right now, and where they will be when they see the video. A person scrolling a phone with the sound off needs the message in the words on screen. A person who clicked a link in an onboarding email will give a tutorial its full length. That last point also decides the format, which comes at the end.
Write the one message, then cut the second
Planners call it the single minded proposition: the one sentence the video has to land. For Replyline it is “answer it once, send it every time”, and it became the narration of scene three almost word for word.
The test is simple. Read the message aloud and ask whether a viewer could repeat it to a colleague after one watch. If you need “and” to finish the sentence, you have two messages. Keep the one that serves the goal and move the other to the next video.
The message is also where honest claims live. The Replyline stat scene shows 41 percent with “across 32 beta support teams” underneath, so the number arrives with its denominator. Put the source of every number in the brief, right next to the number, so it cannot fall off on the way to the screen. If the video will use generated pictures of people, note that too, since some platforms expect a label; the rules are summarised in do you have to disclose an AI generated video.
List the assets and the proof
A brief should say what exists, not what would be nice. Product screenshots, photographs of the actual shop, a logo, a price list, the report with the number in it. For each one, say what it shows and whether it must appear. A listing video built on six photographs of the flat, like the Lisbon listing example, plans itself around those six pictures. A brief that promises “some photos” gets placeholders.
Proof is the asset people forget. A launch needs one number, a quote or a before and after. A sale needs the offer written exactly, exclusions included: the 48 hour sale video says “Excludes gift cards” in its closing scene because the brief said so. Terms that are not in the brief do not reach the final scene.
The W3C’s accessibility guidance makes a related point. Information that only lives in the pictures, a chart, a price, a name on a card, is missing for anyone who cannot see it, and it says integrated description is easier and better when it is included in the script from the start. So if a number or a chart is the point of a scene, write it into the brief as words the narration can say.
Set format and length last
Format follows the audience’s moment. Phone viewers on Reels, TikTok or Shorts get vertical 9:16; a website, a listing portal, YouTube or a slide in a meeting get landscape 16:9. LinkedIn’s video ad specification accepts 16:9, 9:16, 1:1 and 4:5 at anything from 3 seconds to 30 minutes, which is a reminder that the platform will not make this choice for you.
Length follows the goal. Vidyard’s benchmark of close to a million videos made on its platform in 2024 found that 65 percent of viewers stay to the end of a video under a minute, against 20 percent for videos over twenty minutes. Wistia’s 2026 report, covering more than 13 million videos, puts the average engagement rate for videos under a minute at 52 percent. A promo with one action rarely needs a minute; a tutorial with five steps needs as long as five steps take. The length arithmetic by placement is in how long should a promo video be.
The table under this post turns all of it into fields and fills them in for the Replyline brief. Where the published brief left a field implicit, the table writes out what it implied, so you can see what a complete one looks like before you write your own.
Common mistakes
A goal with no verb. “A video for the new range” has no last scene. Say what the viewer does.
Two messages joined by “and”. The video splits its scenes between them and lands neither.
Numbers without a source. A stat nobody can trace gets cut in review or, worse, survives it.
Adjectives instead of assets. “Premium, modern, clean” is a mood, not material. Name the pictures you actually have.
Writing the whole script inside the brief. A brief that dictates every line leaves no room to fit words to scenes. Give the message and the must include lines. If you do have a finished script, label it as the script.
Forgetting the fine print. Offer terms, licence numbers and legal lines belong in the brief, or they are missing from the final scene.
Build it
The AI video generator takes a brief of up to 8,000 characters, plus up to 8 images and 5 documents. Documents are summarised rather than transcribed, so type the exact numbers and wording into the brief itself. You pick one of three types: Promotional, Tutorial, which needs the Starter plan, or UGC, which needs Pro. The length you choose becomes a scene budget, 3 to 6 scenes for short, 4 to 9 for standard and 6 to 12 for long, and the format is landscape or vertical. Narration, voice and captions can then be changed scene by scene in the builder. The steps are in the tutorial on making a promo video with an AI voiceover.
| Field | What to write | Example from the Replyline brief |
|---|---|---|
| Goal | The one action a viewer takes afterwards | Start a free trial of Saved Replies |
| Video type | Sell, teach, or speak as a creator | Promotional |
| Audience | Who they are and the moment they are in | Support team leads answering the same question 40 times a day |
| One message | The sentence a viewer could repeat after one watch | Answer it once, send it every time |
| Proof | One number, quote or before and after, with its source | First reply time down 41 percent across 32 beta support teams |
| Call to action | The exact words of the ask | Try it free |
| Tone | Two or three words | Confident, plain, quick |
| Assets | What exists and what each one shows | Product name, feature name, three dashboard figures |
| Must include | Lines that must appear exactly | The product name spelled Replyline |
| Format | Landscape, vertical or both, by where it runs | Landscape 16:9 for the launch page and email |
| Length | A scene count or a seconds target | Six scenes, under 30 seconds |
| Language | The language of the narration and on screen text | English |
A finished example
This SaaS launch video example announces one feature, saved replies in a fictional helpdesk tool, in six landscape scenes, and the full script with roles and seconds is below. The arc is the launch shape most promos use: name the release, tally the pain, show the fix, put the product on screen, land one number, ask once.
Read the saas feature launch video exampleQuestions people ask
How long should a video brief be?
One page is plenty, and a short promo can be briefed well in three or four sentences. The Replyline launch brief is three sentences and still names the goal, the audience's pain, the proof number and the ask. Length is not the test. The test is whether someone could make the video without ringing you, and whether every scene in the result traces back to something you wrote.
What is the difference between a video brief and a script?
A brief says what the video must achieve and what it must contain: the goal, the audience, the one message, the assets and the format. A script is the words spoken and shown, scene by scene, with timings. The brief comes first and the script is judged against it. If a line in the script serves nothing in the brief, the line goes, however good it sounds.
Should the brief include the exact wording I need?
Only for the lines that must appear exactly: an offer code, legal exclusions, a licence number, a product name with an unusual spelling, or a call to action your team has already approved. Quote those and mark them as must include. Leave the rest as the message and let the scene plan decide the words, because lines written without knowing the scene length rarely fit it.
Can I write the brief in one language and get the video in another?
Yes, if you name the language as a field, the way the Lisbon listing and the Valencia restaurant example briefs name Portuguese and Spanish. Keep names, prices and codes exactly as they should appear. Then have a native speaker check the finished narration before it goes out, because a correct translation can still pick the wrong regional word for your audience.
What if I have no proof number yet?
Use a different kind of proof rather than inventing one. A short customer quote, a before and after of the same screen, a feature shown working, or a plain fact such as a price or opening hours can all carry the proof scene. What should never happen is a round number with no source. If the number is not ready, publish without it and add the stat in a later cut.
Who should approve a video brief?
The person who owns the goal, usually whoever will judge whether the video worked, plus anyone who owns a must include line such as legal wording or pricing. Get their agreement on the brief before a script exists. Changing the goal after a draft costs a whole draft, while changing it on a one page brief costs five minutes and saves an argument later.
Do I need separate briefs for vertical and landscape versions?
Usually not. One brief with both formats named is enough, as long as the on screen text works in a narrow frame. Say which version matters most, because that one decides how much text each scene can carry. Then check the second format on its own before exporting, since a line that sits comfortably across a wide frame can wrap badly in a tall one.
Written by
Indunil Asanka · Co-founder
Builds the generation pipelines behind OneCraft: the slide, flyer and poster layout engines, the document grid and the render workers that turn a written brief into a finished file.
LinkedIn profileWritten and checked by the OneCraft team. Last checked .
Make your own video
Describe what you need and the generator writes and designs it, then you edit anything you like.
See what it can makeRead next
How to make an explainer video
To make an explainer video, write five scenes in order: the problem, the solution in one sentence, how it works in a few short steps, one piece of proof and a single ask. Write the narration first, give each scene one idea and one picture, and keep the whole thing well under the few minutes viewers actually stay for.
How long should a promo video be?
Completion data from two large samples agrees that a business video is finished only if it ends before the minute, and the ad platforms cut off far earlier than that. The useful answer is a length per placement plus a scene budget that makes the length real rather than aspirational.
How to write a tutorial video script
A tutorial script is a list of steps with one sentence of why on each, spoken slower than an advert and shown one action at a time. The numbers are what make it work: seconds per step, words per step, and exactly one screen per step.
For the steps inside the builder, read the guideon this topic.