How to Design Your App’s Walkthrough

How to Design Your App’s Walkthrough

Most SaaS products require at least some in-app onboarding to activate your new users.

Feeling lost where to start and how to design an effective user onboarding for your app, ideally without coding?

If this is you, read on.

We’ve worked with thousands of SaaS companies on their app walkthroughs over the years and have listed all our walkthrough design tips in one place.


    • A walkthrough is an interactive guide through the features a user needs in order to activate.
    • A walkthrough is not a blow-by-blow tour of all your app’s features one by one. That’s a product tour.
    • Your welcome screen should greet users by name with a photo of one of your team, introduce your business, and explain any next steps.
    • It’s also an opportunity to collect mission-critical information about your users like role, company size, and Job-To-Be-Done via a microsurvey. You can then effectively segment your users by their goals, and build personalized onboarding flows for each segment to get them to their ‘Aha! Moment’ faster.
    • Give your user a checklist of activation steps.
    • For each step, build an experience flow that is easy to follow along.
    • It’s significantly easier to build your app’s walkthrough using a walkthrough tool than it is to code it from scratch.
    • The best walkthrough tool for web based apps on the market is Userpilot.


What is an app walkthrough?

walkthrough example

To make sure we’re on the same page, let me first explain what I mean by an app walkthrough.

During an app walkthrough, your user will try out a small number of key features of your app – the key activation points.

Ideally, those are the specific features that a particular user needs to get acquainted with in order to derive maximum value from your product.

Once your user has finished their walkthrough, they will have experienced the value of your product in a first-hand, visceral way.

This means that they will have activated, making them significantly less likely to churn.

Given just how much activation correlates with retaining users for a long period of time, activation should be the goal of your app’s walkthrough.

Your app’s walkthrough is not a product tour!

When some SaaS executives hear the words “walkthrough,” they start to think of an extensive, blow-by-blow guide to all the product features.

product tour

This type of guide is called a “product tour,” and it’s very different from an app walkthrough.

Where a walkthrough is interactive, encouraging simple actions on behalf of your users, a product tour is passive.

Put another way, a the content of a product tour is determined by SaaS executives in advance. It’s a top-down, linear process.

Whereas, the content of an app walkthrough is based on the responses of your users and their actual actions.

They are an active part of the process.

It’s essential that you understand the distinction between a walkthrough and a product tour before we go any further.

It doesn’t matter how pretty the design is: if your walkthrough is actually a product tour in disguise, no one will want to use it.

product tours suck

You have been warned!

App walkthrough tip #1 – Start with the welcome screen

Your app’s walkthrough should begin with a welcome screen.

This is where you formally greet your new users for the first time and welcome them to your app.

From a design perspective, the welcome screen is normally what’s known as a “dedicated UX pattern.”

This means that, since the welcome screen is such an important component of your walkthrough, the entire screen is dedicated to it, to avoid your user getting distracted.

welcome screen

Alternatively, the welcome screen can be designed as an embedded UX pattern, with the space around it greyed out, like this example from social media app Postfity:

postfity welcome screen

Regardless of which type of UX pattern you choose, you’ll want to make sure that your welcome screen contains the following design elements:

Greet your user by their first name

Ideally, you will have asked your user to record their name during the sign-up flow that precedes your app’s walkthrough.

The walkthrough is a great time to mention the user’s name. People love feeling like the product they’re using is personalized to their needs and speaking to them as an individual.

Include a photo of one of your team

Kontentino welcome screen

Remember that you want to leave the user feeling like you’re greeting them personally and really care about them.

In a digital world, a picture of a real person is often more emotionally engaging than some dry words on a screen.

The more friendly and smiley, the better.

Introduce your business

If your marketing department has created a pithy, one-sentence description of what your app does, the welcome screen is a great place to include that.

You don’t want to come across as too sales-y, but you do want to remind the user why they signed up and what value they can expect to derive from your app.

Highlight any next steps

It’s important with any onboarding process that your user knows what to expect next.

Normally, the next steps will be some combination of:

For some inspiring examples of successful welcome screens designed by other SaaS companies, check out this post.

App walkthrough tip #2 – Assign your user to a segment

You may recall from earlier that we said you need to make your app’s walkthrough as personalized to the needs of the individual user as possible.

A crucial step in the walkthrough process is therefore to assign your user to a customer segment.

The content that the user sees in the rest of the walkthrough will be determined by what segment they are assigned to.

Segment using a microsurvey

From a design point of view, the best way to set up your UX to segment your users is by using a microsurvey.

This is a survey with 1-3 questions that pops up in-app and displays as an embedded UX pattern.

Here’s a microsurvey that social media scheduling app Kontentino built with Userpilot:

kontentino microsurvey

Kontentino has two main user personas:

  1. The brand that has one set of social media accounts to manage and post from.
  2. The agency who manages multiple sets of social media accounts from multiple clients, and needs to get approval from each client before posting on their behalf.

It wouldn’t make much sense to provide a single brand with an app walkthrough that shows how to post from multiple client accounts.

Kontentino therefore uses this microsurvey to figure out which segment their users belong to ahead of time.

Hopefully, you can see that the welcome flow of an app walkthrough is not just a place to be cutesy and share smiley pictures.

In fact, if you were to view it that way, your customer would probably just feel resentful that you put another barrier in the way of them using your app.

Rather, your welcome flow is an opportunity to learn more about your user, and then customize the remainder of their product experience accordingly.

App walkthrough tip #3 – Aim your app’s walkthrough towards activation

Once you know what segment the user belongs to, you should have an intuitive sense of what value they want to see from your app if they are going to stick around.

For example, for a project management tool, if your user is:

  • A project manager: They probably want to see features that help them keep all the projects organized.
  • An accountant: they’re likely most interested in viewing financial information for each project.
  • The CEO: they probably want to use features like a Gant chart to have a look at the big picture of their business.

You can see from these examples that value is subjective. In other words, what one user cares about is often of no interest to a different type of user.

It’s your job to create multiple interactive walkthroughs that really speak personally to the individual needs of each customer.

If you really don’t know what value a particular user cohort needs in order to activate, look at your product analytics.

userpilot product analytics

There is probably one or more feature that is consistently not being used by customers who churn early, but is always being used by customers that stick around for months.

That’s probably what you want to design the walkthrough for your app around – the features used by the “successful” user cohort.

Remember that your users really need to experience the value of your product if they are going to activate.

App walkthrough tip #4 – Create a checklist containing 2-3 activation steps

The checklist is the point where you pull together all the work you’ve done so far.

You should serve each user with a checklist containing the 2-3 key actions they will need to take to activate, based on the answers they provided in your microsurvey.

The checklist should display as an embedded UX pattern so that it’s disruptive enough to get the user’s attention but doesn’t take up the entire screen.

Look at how Postfity does it:

postfity checklist

Postfity requires customers to take two actions in order to activate:

  1. Connecting their social media account
  2. Scheduling a post

Note that Postfity already gives users credit for signing up and creating an account.

That’s bound to make them feel good. It’s less overwhelming to think about completing a checklist that you’ve already started than it is to start from zero.

The rest of the checklist is designed with a psychological principle called the Zeigarnik effect in mind.

The Zeigarnik effect states that humans are more likely to remember tasks that are incomplete than those they’ve already finished.

So by making a checklist containing steps towards activation, Postfity is ensuring that those steps remain top of mind for their new customers.

App walkthrough tip #5 – Build experience flows for your app’s walkthrough

Now we’ve reached the core of the walkthrough.

For each item on the checklist you made, you should design an experience flow that guides your customer through the activation step they need to take.

The word “flow” in this instance comes from the fact that an experience flow consists of multiple UX elements, and your customer flows between them seamlessly while they learn to use your app.

experience flow

Custom events

If there are multiple checklist todos that need to be completed in a certain order, you can use custom events to ensure that the second to-do only displays to the user after the first one is complete.

For example, Kontentino’s walkthrough asks the user to first connect their social media account…

kontentino connect account

… and only then make their first post.

kontentino make first post

There wouldn’t be much sense in asking the users to make a post before connecting their accounts. Instructions like that would only lead to churn.

You can read more about custom events here.

The following design elements are commonly used in experience flows to show the customer what to do:


tooltip example

Tooltips are an annotated UX pattern often used to draw attention to a section of the user interface which is not immediately intuitive.

They are generally not visible by default. Instead, they appear when a user hovers or taps on a particular part of the walkthrough.

As well as using tooltips as part of experience flows during onboarding, you might also consider using them elsewhere in your app as a standalone help tool.

Demo content

demo content example

Demo content is made-up placeholder data that shows your customers what your app could look like once filled with their data.

It’s often used in walkthrough design as a substitute for white space, which is called an “empty state” in the walkthrough world.

That’s because it’s less overwhelming for the user to start using a tool that already has some data in it than it is to start from scratch.

When you design your demo content, just make sure that it’s something that’s actually relevant to your customer’s use case.

For example, if a digital marketing company is using your project management app and it’s filled with fake data about swimming pools, your walkthrough will probably confuse users more than it enlightens.

It should also be obvious from how you design it that your demo content is fake data, and that it will vanish once the user adds their own real data — either during or immediately after the walkthrough.


A slideout is a small panel that slides onto the slide of the screen when you want to highlight an action that you want to drive.

It’s an embedded UX pattern, so smaller and less aggressive than a modal that would take up the whole screen.

Nevertheless, the size and motion of a slideout are normally enough to get the attention of most users.


hotspot userpilot

A hotspot is a small dot that pulsates softly on top of the user interface.

As an annotated UX pattern, it’s often used to draw attention towards one particular action that you want your user to take as they proceed through their walkthrough checklist.

It’s important that you only highlight one action at a time.

If you use too many hotspots, your user won’t know where to click, and you’ll just end up confusing them.

Is it possible to code your app’s walkthrough yourself?

The answer to this question will depend on your level of technical prowess.

Bear in mind that you need a lot of code to build even the simplest of design elements for your app’s walkthrough.

So for a simple tooltip that looks like this…

html tooltip
Source: Educba

You’d need this much code:

<title>HTML tooltip</title>
.arrowpopup {
position: relative;
display: inline-block;
cursor: pointer;
.arrowpopup .tooltiptext {
visibility: hidden;
width: 160px;
background-color: #856;
color: white;
text-align: center;
border-radius: 4px;
padding: 9px ;
position: absolute;
bottom: 150%;
left: 50%;
margin-left: -85px;
.arrowpopup .tooltiptext::after {
content: "";
position: absolute;
top: 100%;
left: 50%;
margin-left: -5px;
border-width: 5px;
border-style: solid;
border-color: #856 transparent transparent transparent;
.arrowpopup .show {
visibility: visible;
<body style="padding:100px;">
<div class="arrowpopup" onclick="myFunction()">Tooltip Demo Click here!
<span class="tooltiptext" id="tooltipdemo">HTML Tooltip helps you to display extra information of element.</span>
function myFunction() {
var tt = document.getElementById("tooltipdemo");


And to be honest, this tooltip is not especially visually appealing either. The more aesthetically pleasing the tooltip, the more code you’ll probably need.

So it’s up to you: if you’re a coding wizard, or your development team has lots of spare time on their hands, you could build your walkthrough yourself.

In practice, we’ve found that most of the SaaS teams we’ve worked with use a walkthrough tool to reduce the amount of labor.

A code-free walkthrough

The great thing about walkthrough tools like Userpilot is that you generally need no coding experience to use them. And you can still build beautiful walkthroughs, like this example:

userpilot walkthrough example

Userpilot was designed specifically with onboarding in mind, so the range of different UX patterns you can chain together to highlight checklist items to your customers is really unparalleled.

userpilot ux options

It’s easy to customize any part of your UI to fit your brand’s unique personality and color scheme.

userpilot customization

In terms of coding, all you need to do is install Userpilot’s JS snippet. After that, there’s literally zero additional code required.

I am entirely non-technical and was able to learn the basics of Userpilot in a matter of minutes.

Prices start from $249 per month for up to 2500 MAUs, without any limitations on the features.

And the best part is: you can try Userpilot completely for free!

Get a demo today!


Having read this article, you should now be in a position to build a walkthrough for your own SaaS product.

Remember that the most important components of your app’s walkthrough are:

  • The welcome screen
  • The microsurvey that segments users
  • The checklist of activation tasks
  • The experience flows for each activation task

If your walkthrough contains all of these elements, and your users complete it, they will activate every time just by finishing the walkthrough.

And what’s even better is: you don’t even need to be a coding genius to build a walkthrough like this!

Tools like Userpilot empower product managers to build captivating walkthroughs directly in the browser — code-free.

To see what Userpilot can offer your app’s walkthrough, click on the banner below.


previous post next post

Leave a comment