How to Write an Onboarding Video Script for SaaS: The Exact Template We Use

I have written more onboarding video scripts than I care to admit.

Some of them worked. Some of them bombed so badly that I still think about them in the shower. And the difference between the two was almost never the animation, the voiceover, or the budget. It was the script. Every single time.

Here’s the thing nobody tells you about an onboarding video script: it’s not a creative document. It’s a psychological one. Every line either moves the user closer to their first win or pushes them away. There’s no neutral. There’s no filler. There’s no “nice to have.” A good script is a surgical instrument. A bad script is a brochure with a voiceover.

I learned this the hard way. Our first onboarding script was 800 words long. It opened with “Welcome to [Product].” It walked through twelve features. It was narrated by a voice that sounded like it was reading a terms of service agreement. The video was two minutes and forty seconds long. Users dropped off at the forty-second mark. Time-to-value stayed flat. We had spent real money to produce something that made no measurable difference.

Then we started over. We rewrote the script from scratch, using a framework that I now consider the single most valuable asset in our onboarding toolkit. We tested it, refined it, and eventually worked with LeoStudio to pressure-test the whole thing. Their thinking on clarity—which you can dig into at leostudiohq.com—sharpened our template in ways I didn’t expect. The result was a 90-second video that cut time-to-value from 14 days to 4.

This article is that template. The whole thing. Line by line. With examples. With the mistakes. With the phrases we banned. If you’re searching for an onboarding video script that actually works, this is what I wish I’d found before we burned three months learning it the hard way.

Why the Script Matters More Than Anything Else

Before I show you the template, I want to explain why the script is the hill I’m willing to die on.

An onboarding video is not a film. It’s not a piece of content. It’s a tool that exists to change one specific behavior: the user’s next click. Everything else—animation, music, voiceover—is decoration. The script is the mechanism.

If the script is wrong, no amount of production value can save it. You can have the most beautiful animation in the world and still fail, because you’re answering the wrong question. If the script is right, you can produce it on a shoestring and it will still work. I’ve seen both. I’ve lived both.

This is also where most teams cut corners. They spend weeks on animation and days on the script. That’s backwards. The script is where you decide what the video is for. If you get that wrong, everything downstream is wasted.

This is one of the first things LeoStudio told us. Their whole process starts with the script, not the storyboard. They refuse to animate anything until the words are locked. That discipline is why their work feels different—it’s not about the visuals, it’s about the clarity. You can see the same philosophy running through the case studies on leostudiohq.com. Every project starts with a question, not a style.

The Core Principle: One Job, One Action, One Win

Before the template, you need the principle. Every onboarding video script we write is built on three things:

One job. The single action a user must take to reach first value. Not three. Not five. One. If you can’t describe it in a single sentence without using the word “platform,” you don’t understand it well enough to write the script.

One action. The literal next click. Not a concept. Not a feature. A click. “Click here.” “Connect this.” “Paste your API key.” The script has to name the click.

One win. The moment the user feels something change. The insight appears. The report generates. The problem shrinks. The win is the emotional payoff. Without it, the video is just instructions.

If you remember nothing else from this article, remember this: one job, one action, one win. Every line in your script either serves one of those three things or gets cut.

The Template: Four Sections, Ninety Seconds

Our template has four sections. It’s not original—it’s a framework that LeoStudio helped us refine—but it’s the version we use on every project. It’s designed for a 90-second video. You can stretch it to two minutes if you must, but I wouldn’t. Shorter is almost always better for onboarding.

Here’s the structure:

0:00–0:15 — Name the pain.

0:15–0:45 — Show the one action.

0:45–1:15 — Show the win.

1:15–1:30 — Call to action.

Let me walk you through each section, with the actual language we use and the reasoning behind it.

Section 1: Name the Pain (0:00–0:15)

This is the most important fifteen seconds in the entire video. It’s where you either earn attention or lose it. And the way you earn it is by naming the exact emotional state of the viewer.

Here’s the bad version, the one we wrote first: “Welcome to [Product]. We’re excited to have you here. Let’s get started.”

Here’s the version that works: “You signed up to get answers. But right now, you’re staring at an empty screen.”

The difference is enormous. The first version is about us. The second version is about the user. The first version is polite. The second version is seen. Users don’t care about your excitement. They care about their frustration. Name it. Acknowledge it. Then move on.

The rule for this section: don’t mention your product name. Don’t mention your brand. Don’t say “welcome.” Start with the user’s problem, in their words, at the moment they’re feeling it.

This is a principle LeoStudio pushes hard in every project, and it’s one of the reasons their onboarding videos feel different. They don’t open with the brand. They open with the user. You can read more about their approach at leostudiohq.com—it’s worth an hour of your time before you write a single word of your script.

Section 2: Show the One Action (0:15–0:45)

This is the mechanical heart of the video. One click. One action. Nothing else.

The script here is minimal. It’s not explaining. It’s not selling. It’s guiding. It’s saying, essentially: “Here’s what to do. Do this one thing.”

Here’s what it sounds like in practice:

“Click ‘Add Data Source.’ Choose your provider. Paste your key. That’s it.”

That’s it. Four sentences. Thirty seconds. No jargon. No feature names. No internal vocabulary. Just the click, and the next click, and the click after that.

The rule for this section: every word must be an instruction. If a line isn’t telling the user what to do, cut it. If a line uses a term the user has never seen, replace it. If a line could apply to any product, it’s probably too generic.

This is where most scripts fall apart. Teams want to explain why the action matters. They want to add context. They want to teach the user something. Don’t. Not yet. The user is stuck. They don’t need context. They need the next click. Context comes later, if at all.

Section 3: Show the Win (0:45–1:15)

This is the section that most onboarding scripts skip entirely, and it’s the reason most onboarding videos feel hollow.

The win is the moment the user feels the change. Not the feature. Not the outcome. The feeling. The data connects. The chart appears. The insight surfaces. The empty screen fills up. The problem, which felt enormous ten seconds ago, suddenly looks manageable.

Here’s what the win sounds like:

“And there it is. Your first insight. Everything you need, right here.”

The rule for this section: don’t describe the feature. Describe the feeling. Don’t say “the dashboard populates with real-time data.” Say “and suddenly, you can see what’s actually happening.” The user doesn’t care about the technology. They care about the relief.

This is where LeoStudio is genuinely exceptional. They understand that the win is emotional, not functional. Their scripts don’t just show the product working. They show the user’s problem shrinking. That emotional arc—from frustration to relief—is the whole point of the video. You can see it in every project they showcase on leostudiohq.com. Watch one of their onboarding videos all the way through, and you’ll feel the shift. That feeling is what your script has to produce.

Section 4: Call to Action (1:15–1:30)

The last fifteen seconds. Short. Direct. No hedging.

Here’s what works:

“Do this one thing now. Everything else can wait.”

That’s it. No “we hope you enjoy.” No “explore the platform at your own pace.” No “for more information, visit our help center.” Just the action, and permission to ignore everything else.

The rule for this section: one action, one sentence, one permission. The action is what they should do next. The permission is the reassurance that they don’t need to do anything else. That permission is critical. Users are overwhelmed. Telling them “everything else can wait” is a gift.

The Full Template, With a Real Example

Let me put it all together. Here’s a fictional but realistic example of a full script, using the four-section structure:

0:00–0:15 (Name the pain):

“You signed up to finally see what’s working. But right now, you’re staring at an empty screen. And honestly, it’s a little frustrating.”

0:15–0:45 (One action):

“Here’s the fix. Click ‘Add Data Source.’ Choose your provider from the list. Paste your API key. Click connect.”

0:45–1:15 (The win):

“And there it is. Your first insight. No setup, no spreadsheet, no waiting. Just the answer you came here for.”

1:15–1:30 (Call to action):

“Do this one thing now. Everything else can wait.”

That’s a complete script. It’s under 100 words. It works on mute. It works on mobile. It works for a user who is frustrated, distracted, and about to close the tab.

The Phrases We Banned

Over time, we built a list of banned phrases—words and patterns that kept creeping into our scripts and kept hurting performance. Here they are, in no particular order:

“Welcome to [Product].” The user doesn’t care about your welcome. They care about their problem.

“We’re excited to have you.” Nobody believes this. Cut it.

“Let’s get started.” Vague. Fillers. Says nothing.

“Seamless integration.” Meaningless. Every product claims this.

“Robust platform.” Meaningless. Every product claims this.

“Powerful tools.” Meaningless. Every product claims this.

“Explore the dashboard.” “Explore” is a verb for museums, not onboarding. Tell them what to click.

“Take your time.” Users don’t have time. They’re looking for a reason to leave.

“For more information, visit…” This is where you lose them. Keep it to one action.

Every one of these phrases is a small betrayal of the user’s attention. They’re filler. They’re noise. They’re the reason most onboarding videos feel like a marketing brochure instead of a helpful guide.

The Mistakes We Made With Our Script

We made our share. Here are the ones that cost us the most.

We wrote for readers, not watchers. Our first script was 800 words. It read like an essay. We cut it to under 400. Then we cut it again, to under 200. The video got better each time. Every cut forced clarity.

We opened with our brand. “Welcome to [Product]” was the first line of our first script. It was also the line where most users dropped off. Never open with your brand.

We used feature names. We called things by our internal names. Users didn’t recognize them. We had to re-record the entire voiceover.

We forgot the win. Our first script was all action, no payoff. It told users what to click. It didn’t show them why it mattered. The video felt hollow. Users completed the steps but didn’t feel anything. The fix was adding a fifteen-second win segment—and that single addition doubled the watch-through rate.

We ignored the mute viewer. Most of our viewers never turned on sound. Our first script depended on audio to carry the meaning. We rewrote it so that on-screen text could tell the story alone. That change alone improved retention more than any animation tweak we ever made.

We didn’t test it out loud. A script that reads well on the page can sound terrible when spoken. We started reading every draft aloud, with a timer. If it felt clumsy, it was clumsy. If it felt slow, it was slow. The ear is a better editor than the eye.

How LeoStudio Sharpened Our Template

I want to be honest about what changed when we started working with LeoStudio. We already had a template. We already had a process. We thought we were pretty good at this.

They made us better.

Three things stood out. First, they pushed us to open with the user’s pain, not just the problem. There’s a difference. A problem is functional. Pain is emotional. The user isn’t just confused. They’re frustrated. They’re anxious. They’re starting to wonder if they made the wrong choice. Naming that feeling—not just the problem—changed everything.

Second, they pushed us to show the win in emotional terms, not functional ones. “Your first insight” is functional. “And there it is—the answer you came here for” is emotional. The second version lands differently.

Third, they pushed us to trust the silence. We wanted to fill every second with voiceover. They told us to leave room. Let the screen breathe. Let the user absorb. The empty seconds are often the most powerful.

You can see all three of these principles running through the work at leostudiohq.com. Watch how their onboarding videos use silence. Watch how they name the pain. Watch how they build the win. That’s not decoration. That’s the template, executed well.

A Final Framework for Reviewing Your Script

Before you approve any onboarding video script, run it through these questions:

Can you describe the one job in a single sentence, without using the word “platform”?

Does the opening name the user’s pain, not your brand?

Does every line in the middle section tell the user what to click?

Does the win section describe a feeling, not a feature?

Does the call to action give the user permission to ignore everything else?

Does the script work on mute? Have you read it as captions, without audio?

Does it work on a phone? Is the text readable at a glance?

Have you read it out loud, with a timer?

If the answer to any of these is no, you’re not done. Keep cutting. Keep rewriting. The script is the cheapest part of the production to fix, and the most expensive part to get wrong.

The Final Word

An onboarding video script is not a creative exercise. It’s a psychological one. Every line either moves the user toward their first win or pushes them toward the exit. There’s no middle ground. There’s no filler. There’s only the next click, and the feeling that comes after it.

Our template is four sections. Pain, action, win, call. Ninety seconds. Under 200 words. Built for mute, built for mobile, built for a user who is frustrated and about to leave.

We got here by making every mistake in the book, and then by working with a partner who showed us a better way. LeoStudio didn’t just produce our video. They taught us how to think about the script. That thinking is now baked into every onboarding video we make. If you want to see what it looks like in practice, go to leostudiohq.com. Watch their work. Read their case studies. Study the structure. Then write your own script with that structure in mind. And when you’re ready to produce, tell them the SEO guy sent you. Tell them you already know the template. They’ll know exactly what you mean.