Step 1: Add the Userpilot Snippet to Your Web App
The first step is technical, but it’s quick: you need to install the Userpilot JavaScript snippet into your application. This snippet is what connects your app to Userpilot, allowing us to track users, render experiences, and power your analytics. You have a few installation options:- Manually via your app’s codebase
- Through Google Tag Manager
- Using Segment, if that’s already part of your stack

Once installed, you’ll be able to verify it in your Userpilot dashboard and start seeing live user activity. We recommend looping in your dev team here, it’s a one-time task.Installation Instructions
While your engineering team completes the installation, you can proceed with installing the Chrome extension to ensure you’re ready to start building as soon as setup is complete.
Step 2: Install the Chrome Extension
This step is crucial and often overlooked: install the Userpilot Builder Chrome Extension. This extension is your control panel for everything visual in Userpilot. It lets you:- Build flows, spotlights, banners, and buttons directly on your web app
- Label an event with no code
- Preview how things look before launching
You can’t create in-app messages without this. So, before you even think about onboarding experiences, get the extension installed and ready.Install the Builder Extension

Step 3: Send in Your User and Company Data
To deliver the right experiences to the right users, Userpilot needs context. That’s where your user and company data come in. You’ll want to send:- User-level data like: user ID, email, role, signup date, and plan
- Company-level data like: company name, account ID, size, MRR, industry
Why this matters: You’ll use this data to segment users, trigger flows, and analyze performance later. You can pass this through the snippet, via Segment, or through our API.How to Set Up User & Company Properties

Step 4: Track Events and label an event
You want to know who did what and when. Start labeling events and defining key ones. There are three ways to do this:- Tag UI elements visually using the Chrome extension. For example, tag a “Create Report” button or a “Billing” tab.

- Label an event using CSS by adding the element’s CSS selector to start tracking it. If you don’t have the selector or find it difficult to get, no worries, you can ask your dev team for help or reach out to us via chat
- Track event programmaticlly like “Upgraded to Pro Plan” or “Completed Onboarding” by pushing them via code

These events power targeting, reporting, and personalization. The more intentional your event setup, the better your insights will be later. Labeled Events (Visually/CSS)
Step 5: Create Your First Flow
Flows are in-app experiences that guide users through your product. Think of them as conversations timed just right, based on what your user is doing or needs to do next. Examples include:- A tooltip that shows when a user hovers over a new feature
- A multi-step modal that introduces your app to first-time users
- A slideout that nudges users to finish the setup
- Pick your format: modals, slideouts, spotlights, tooltips, driven actions, banners, or buttons
- Choose who sees it and when
- Launch it without touching the code

Step 6: Use Checklists and Surveys
Once you have flows, take it a step further by layering in checklists and surveys. Checklists help users complete a series of actions, like finishing onboarding, setting up integrations, or publishing their first campaign. They’re great for encouraging completion and reducing time-to-value. Checklists Guide
- CSAT: How satisfied are you with this feature?
- CES: How easy was this task?
- NPS: Would you recommend us

Step 7: Review Your Analytics
You’ve launched experiences. Now it’s time to measure impact. Inside the Analytics tab, you’ll find:- Flow analytics: who saw it, who finished it, where people dropped off
- Feature usage: which features are being used and by whom
- Funnels and paths: user journeys from signup to key milestones
- Retention cohorts: who keeps coming back, and why

Step 8: Customize Your Workspace
As your team scales, you’ll want to set up your workspace properly:- Invite team members and assign roles
- Use staging vs. production environments to test before going live
- Brand your flows to match your product’s look and feel
- Set visibility rules for different flows per environment
Explore What’s Next
You’ve got the basics down. Here’s what you might explore next:- A/B testing your flows to find what converts best
- Creating onboarding paths for different personas
- Setting goals to track flow impact against KPIs
- Building a resource center that lives inside your app
Need Help Along the Way?
We’ve got your back:- Reach out through chat support in the Resource Center within the Userpilot web app
- Book a free onboarding session if you want a guided setup
You’re now ready to build product experiences that convert, retain, and delight without writing a line of code.