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.

FigureFrom everyone to one viewer with one question. Drawn to show the idea.

02

Three viewers, three videos

The viewerStuck onAsks firstThe video shows
A team lead evaluating a tool for the companyWhether it will pass review and fit the stackWill this work at our scale?The setup, the limits, and how it behaves under load
An indie builder shipping this weekendGetting something working todayHow fast can I get this running?One short path from sign-up to a working result
A platform or security ownerRisk, access and what the tool touchesWhat 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