Blog/Strategy
Who is this video for? Start with the viewer
Developers are not one audience. Write one sentence naming the viewer and their first question, then make the video for that person.
Kevin Blanco··6 min read·Every stage
The short answer
"Developer" covers a lot of different people. A team lead evaluating a tool, an indie builder shipping this weekend and a platform owner worried about security need different videos. Before any script, write one sentence naming the viewer: their role, what they're stuck on, and the first question they'll ask. Then make the video for that person.
01
One word, many viewers
Ask a team who their videos are for and the answer is usually "developers". It's accurate, and it's no help. It doesn't tell the script what to open with, how technical to get, or what the ending should ask for.
Narrowing the viewer rarely shrinks the audience. People outside the target can still watch, as long as the video is clearly about a problem they recognize.
02
Three viewers, three videos
| The viewer | Stuck on | Asks first | The video shows |
|---|---|---|---|
| A team lead evaluating a tool for the company | Whether it will pass review and fit the stack | Will this work at our scale? | The setup, the limits, and how it behaves under load |
| An indie builder shipping this weekend | Getting something working today | How fast can I get this running? | One short path from sign-up to a working result |
| A platform or security owner | Risk, access and what the tool touches | What does this have access to? | Permissions, data flow, and what happens when it fails |
The same product serves all three. The videos can't be the same.
03
The viewer card
Fill in four fields. You get one sentence that goes at the top of the brief and the script.
The card
Who is this video for?
Use the viewer's words, not the product's.
The first line of your brief
This video is for [role] who is stuck on [what they're stuck on]. They will ask: "[their first question]"
0 of 4 filled in. Put this sentence at the top of the script.
04
Using the sentence
- 01
Open on their question
The first question they ask is your hook. It tells them in a few seconds that the video is about their problem.
- 02
Cut what the other viewer needs
Every line that serves a different viewer is a line this viewer waits through. Save it for the video made for them.
- 03
Say who it's for
A sentence in the first ten seconds, such as "if you're moving a service to production this week". People decide quickly whether it's theirs.
FAQ
Questions people ask
What is an ideal customer profile for developer video?
A short description of the one viewer a video is for: their role, what they're stuck on, the first question they ask, and where they look for answers. It is narrower than "developers" and specific enough to write a hook from.
Why not make videos for all developers?
Different developers need different things from a video. A video that tries to serve everyone has no clear hook, and each viewer waits through the parts meant for someone else.
How do I find out what my viewer is stuck on?
Read support tickets, community questions and sales call notes, and look at what people search for before they find you. Use their words, not yours.
What if my product serves enterprise teams and indie builders?
Make two videos. The enterprise team lead and the indie builder have different questions, so the hook, the length and the ending differ. Mixing them weakens both.
How specific should the viewer card be?
Specific enough that you can write the first line of the script from it. If two people on your team would describe the viewer differently, it is not specific enough yet.
DevReel
How we do it at DevReel
Every video we make starts with one viewer and their first question. That sentence goes at the top of the brief, and it settles most of the arguments later.
Cloudinary's videos usually average around 400 views. Ours passed 9,000 in the first week. For ngrok, watch hours tripled and subscribers went from about 450 to over 800 in the first week.
Cloudinary views
9,000+
in the first week, against a usual ~400
ngrok watch hours
3×
subscribers from ~450 to 800+ in the first week
Now the hard part
Tell us who you want to reach. We'll turn them into the first line of a brief.

Kevin Blanco founded DevReel. He has made 500+ developer-tool videos and spoken at 80+ developer conferences.
Keep reading
Strategy/Every stage
A video brief engineers will follow
One page, two review checkpoints, and one owner. How to stop the rewrites before they start.
October 13, 2026·6 min read→Strategy/Every stage
One recording, ten assets: build a content system, not a video
Plan the cuts before you record, and one 30-minute session becomes a long video, clips, a blog post, a carousel and more.
October 6, 2026·6 min read→Strategy/Every stage
The video ROI model you can show finance
Cost, activated developers, value per developer and payback, with a low case and a high case. A simple model you can defend.
September 29, 2026·7 min read→