Blog/The developer journey

Retention: video that keeps developers and grows usage

Release videos, advanced patterns and migration guides for the people who already use you, and the support questions they answer.

Kevin Blanco··6 min read·Retention

The short answer

A retention video serves developers who already use you: release walk-throughs, advanced patterns and migration guides. It lowers support load and prepares people for upgrades. Measure tickets on the topics it covers, repeat usage, and visits to the upgrade page from the video.

01

Who's watching

This viewer is a customer. They know the basics and have a real project running on your product.

They need to hear about the changes that affect them, and learn the harder patterns without reading every changelog.

FigureWhere retention sits on the journey, and what it asks of a video.

02

What a good retention video looks like

  • 01

    Short release videos

    What changed, who it affects, how to try it. Ninety seconds is usually enough.

  • 02

    Advanced patterns

    For people past the basics who want to do more with what they already have.

  • 03

    Migration guides

    Before and after, and the exact lines to change.

  • 04

    Honest breaking-change notes

    Say plainly what will break and when. People remember the vendor who warned them.

03

The call to action that fits

The ask at the end should match what this viewer is ready to do. Asking for more than that loses them. Asking for less wastes the video.

The ask that misses

"Stay tuned for more updates."

The ask that fits

"If you use the old endpoint, here's the migration, and the three lines to change."

04

What to measure

  • Tickets

    On the topic

    Support questions about what the video covers, before and after.

  • Repeat usage

    After viewing

    Whether people who watched keep using the feature.

  • Upgrade visits

    From the video

    Visits to the upgrade or pricing page that start from a video.

Support volume is the honest number here. If a video works, people stop asking the question it answers.

05

When results show up

These are rules of thumb from our own work, not benchmarks. Your audience and your volume will move them.

  1. Week 1

    Views from your release email

    Existing users are the easiest audience to reach.

  2. Weeks 2 to 6

    Tickets on the topic

    Compare the weeks before and after.

  3. A quarter

    Upgrades and repeat usage

    Slower to read, and the part that counts.

06

The usual mistake

07

The rest of the journey

FAQ

Questions people ask

What is a retention video?

A video for developers who already use your product: release walk-throughs, advanced patterns and migration guides that keep them current and reduce support questions.

How long should a release video be?

Short. About ninety seconds covers what changed, who it affects and how to try it. Link to the notes for detail.

Can video reduce support tickets?

It can, for the topics it covers. Measure tickets on those topics in the weeks before and after, and expect the effect to take a few weeks to show.

What should a migration video include?

A before and after, the exact lines to change, what will break, and the date. Keep the code readable on screen and link the snippet.

How long until retention video shows results?

Views arrive in the first week, ticket changes in two to six weeks, and upgrade and repeat-usage effects over about a quarter. These are rules of thumb.

DevReel

How we do it at DevReel

For retention we start with the questions customers keep asking, and make the shortest video that answers each one. Release videos get the same treatment, so they stay short.

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 what your customers keep asking support. We'll plan the videos that answer it.

Kevin Blanco founded DevReel. He has made 500+ developer-tool videos and spoken at 80+ developer conferences.

Keep reading