How to Automate Your Onboarding Journey Using Braze Canvas

Key Takeaways

• Define your conversion event before building, it cannot be edited after launch.
• Use action-based entry triggers for real-time onboarding rather than scheduled batches.
• Build behavior-based splits using Action Paths and Audience Paths, not just time delays.
• Layer in Intelligent Channel selection so Braze routes each message through the highest-engagement channel per user.
• Suppress overlapping campaigns during the onboarding window to protect the experience and reduce message fatigue.
• Measure activation rate, time to first conversion, and revenue per Canvas entrant, not opens and clicks.
• Start with a clean five to seven day flow and add complexity iteratively as you gather behavioral data.

Your product might be exceptional. Your acquisition strategy might be converting. But if your onboarding experience falls flat in the first few days after signup, most new users won't stay long enough to discover the value you built for them.

The first week after a new user signs up is simultaneously the highest-risk window for churn and the highest-opportunity window for activation. Research from Braze's 2024 Retention Guide found that brands see an average 56% uplift in 90-day retention for each additional channel added to their engagement mix, and onboarding is where those channels first come together. Miss this window, and you're spending acquisition budget to fill a leaky bucket.

Braze Canvas is the tool that turns that window into a competitive advantage. It lets you build intelligent, automated onboarding journeys that adapt in real time to what users actually do, not just send a rigid sequence of emails on a calendar schedule. In this guide, we'll walk through every layer of building an onboarding Canvas that actually activates users: from entry triggers and Canvas architecture to Action Paths, cross-channel strategy, suppression rules, and measurement.

Why Most Onboarding Sequences Fail, And What Canvas Does Differently

The traditional onboarding sequence is a linear email series: welcome email on day zero, tip email on day two, check-in on day five. Scheduled. Static. Sent to everyone the same way regardless of what they've actually done since signing up.

The problem is obvious once you see it. A user who completed their profile on day one and started exploring core features doesn't need the same day-two "here's how to get started" email as someone who signed up and never returned. Sending the same message to both doesn't just waste a touchpoint, it actively signals that you don't know who they are.

Braze Canvas addresses this by letting marketers proactively move customers through one journey as they move through the onboarding flow, no splitting multiple events or breaking journeys out by separate API triggers. Just one automated, streamlined action path.

The result is an onboarding experience that responds to behavior in real time. Users who engage move forward differently than users who don't. The journey shapes itself around the individual, and that's what drives activation.

The numbers back this up. Hosco used Braze Canvas to create personalized, multi-path customer journeys to smooth their onboarding flow and nudge users to complete important first steps like finishing their profiles, resulting in a 54% jump in click-to-open rates and 10,000 new job applications from users. HBO Max, using segmented cross-channel onboarding flows, achieved a 3,000% higher subscription rate compared to a one-size-fits-all approach.

Step 1: Define Your Onboarding Goal and Conversion Event Before Anything Else

The most common mistake teams make when building a Braze Canvas onboarding journey is opening the builder before they've defined success. In Braze, your conversion event, the action that determines whether a user has been successfully onboarded, must be set before you launch. It cannot be changed after the Canvas goes live.

So start here: what does a successfully onboarded user look like for your product?

Depending on your business model, this might be completing a profile, making a first purchase, starting a first session, activating a key feature, submitting a first deposit, or reaching a specific milestone in your product. Whatever it is, it needs to be a trackable event in Braze, either a built-in event like "Start Session" or "Make Purchase," or a custom event your engineering team has passed to the Braze SDK.

Set your conversion deadline to reflect your realistic activation window. For most consumer apps and eCommerce products, seven days is a strong default. For complex SaaS products where activation takes longer, extend to fourteen or even thirty days, but be deliberate about it. Your conversion window defines how you measure the Canvas, so it should reflect how your best users actually behave.

Once your conversion event is locked, name your Canvas clearly. A descriptive naming convention like "Onboarding, New User Welcome Series, makes it easier for your team to manage and audit journeys as your Canvas library grows.

Step 2: Set Up Your Entry Trigger and Target Audience

To set up a welcome and onboarding flow, you need to pass a custom event to define your Canvas entry criteria, such as "Registration Completed" or "Account Created", that triggers when your user successfully registers for the first time. This custom event becomes your Canvas entry criteria, letting Braze know which individuals should be added to the Canvas.

Select action-based entry for your Canvas entry schedule. This ensures users enter the journey the moment they trigger the event, in real time, rather than being batched into a scheduled send. Real-time entry is critical for onboarding because momentum is highest at the moment of signup. A welcome message that arrives six hours later because of a batch delay has already missed the peak intent window.

For your target audience, as Stitch, a leading Braze delivery partner, recommends in their Canvas build framework, a clean starting segment for a welcome series targets users who have provided an email address for the first time and have never made a purchase. You can layer in additional Braze out-of-the-box filters, like intelligent channel preference, last app usage, how much money a user has spent, and custom attributes, to make your entry conditions even more precise.

A few additional settings to configure at this stage:

Set re-eligibility to "Never" so each user experiences onboarding exactly once. Configure quiet hours to suppress sends during off-peak times, a common setup is to allow sends from 8:00 AM onward and hold any messages that would otherwise go out overnight until the next morning window. Enable frequency capping if you have other active campaigns running, Braze's built-in frequency capping is one of the few tools in the marketing technology ecosystem that handles this natively, ensuring your onboarding messages don't compete with other sends.

Step 3: Build the Canvas Flow, A Step-by-Step Architecture

This is the core of your onboarding automation. Here is a proven Canvas structure that works across most industries, with the logic behind each step:

Day 0, Immediate Welcome Message

The moment a user enters the Canvas, send a welcome email. Keep it focused: one message, one primary call to action, zero ambiguity about what the user should do next. The goal of this first touch is to orient the user, set expectations for what's coming, and point them clearly toward your defined key action. Avoid cramming in feature lists or promotional offers, that comes later. High-performing welcome series treat each message as having one clear job: educate, activate, convert, or collect preferences.

Delay Step, 30 Minutes to 1 Hour

Always place a delay step after every message. Back-to-back sends without breathing room feel robotic and drive unsubscribes. A short initial delay also prevents the welcome email from landing while the user is still actively exploring your product.

Day 1, In-App Message or Contextual Push

Rather than sending another email at day one, shift channels. If the user is active in your app, surface a contextual in-app message that highlights a specific feature or guides them toward the key action. Braze recommends building in-app messages for onboarding Canvases to make the most out of your first impression, and introducing Content Cards for promotional offers alongside push notifications. If the user isn't active, fall back to a push notification.

Action Path Split, Did They Complete the Key Action?

After day one, introduce a Braze Action Path step. Action Paths let marketers create, define, and trigger user experiences based on the actions customers take during an assigned time period, one of the key Canvas Flow components for building dynamic customer journeys without writing a single line of code.

Define an evaluation window of 24 to 48 hours. Users who completed your key action route to an activation acknowledgment branch. Users who did not are routed into a re-engagement path. This single split is the difference between a linear sequence and a genuinely adaptive journey.

Day 3, Re-Engagement Branch

For users who still haven't activated, send a follow-up email that reframes your value proposition and removes any friction standing between them and the key action. This is also an excellent moment to collect zero-party data, a short preferences survey asking about their goals or use case can both personalize the rest of the journey and give your team valuable segmentation data. Braze's onboarding with preferences survey Canvas template splits users into those who engaged with the initial onboarding email and those who haven't, then targets messaging to each group accordingly.

Day 5 to 7, Final Nudge and Exit

A final in-app message or email with a simple, low-friction CTA. Keep the tone supportive, not desperate. If users reach this point without converting, exit them from the Canvas cleanly and add them to a separate re-engagement segment for a dedicated win-back campaign at a later date. Continuing to message unconverted users indefinitely inside an onboarding Canvas inflates message fatigue and skews your analytics.

Step 4: Use Audience Paths to Personalize Across Segments Within the Same Canvas

One of the most underused capabilities in Braze onboarding builds is the Audience Path step. While Action Paths respond to what a user does, Audience Paths respond to who a user is, splitting the journey based on real-time segment membership.

This matters because not all new users are equal. A user who signed up via a paid social ad has different intent and expectations than one who came through an organic product review. A mobile user engages differently than a web-first user. An enterprise trial user has different needs than a self-serve individual signup.

Use Audience Paths to fork your Canvas based on these differences at the point of entry or at key decision nodes mid-journey. Mobile users get in-app messages and push as their primary channels. Web users get email and content cards. Enterprise users get a more detailed, feature-focused flow. Self-serve users get a faster, frictionless path to the first key action.

Great onboarding doesn't treat everyone the same. Use segmentation to target the right audience, and dynamic personalization tools to tailor content based on past purchases, previous engagement, customer preferences, and more, the more aligned the experience feels to a customer's goals, the more likely they are to stay engaged, leading to increased satisfaction and longer retention.

Combine Audience Paths with Braze's Intelligent Channel feature to automatically route each message step through the channel where that specific user has historically shown the highest engagement. This one configuration can produce meaningful conversion lift without writing a single new piece of copy.

Step 5: Suppress Overlapping Campaigns to Protect the Onboarding Experience

A carefully built onboarding Canvas can be undermined by one thing you didn't configure: other campaigns firing simultaneously.

New users in their first seven days are simultaneously inside your onboarding Canvas and potentially eligible for promotional blasts, event-triggered campaigns, seasonal sends, and re-engagement flows that haven't been scoped to exclude them. Types of campaigns to suppress during onboarding include promotional blasts during the first onboarding window, cross-channel duplicates unless coordinated by a single orchestration plan, and messages triggered by calendar events that don't match a "new subscriber" context.

Set up suppression rules that pause all non-onboarding campaigns for users currently in their onboarding window. Braze's frequency capping handles much of this natively, but for promotional campaigns you may need to add an explicit segment filter, "not currently in onboarding Canvas", to exclude new users from broader sends.

This isn't just about message volume. It's about coherence. A user who receives a "We miss you, here's 20% off" campaign on day two of their onboarding doesn't just get an irrelevant message, they get a signal that you don't know who they are. That erodes the trust your onboarding experience is trying to build.

Step 6: Measure Activation, Not Just Engagement

The trap most teams fall into: measuring open rates and click-through rates as proof that onboarding is working. Those metrics capture attention, not activation. For an onboarding Canvas, the KPIs need to shift.

Activation rate, the percentage of users who completed your defined conversion event within the conversion window, is your primary metric. Everything else is supporting data.

Time to first conversion measures how quickly users reach the key action after entering the Canvas. Behavioral onboarding should shorten this timeline significantly compared to a generic scheduled sequence. Monitor how your onboarding flows are performing by tracking key metrics such as time to value, task completion rates, engagement drop-offs, and retention rates, then use those insights to fine-tune the experience over time.

Drop-off by Canvas step tells you exactly where users are falling out of the journey. A high drop-off between the day-one in-app message and the Action Path split usually indicates the message isn't landing, either the channel is wrong, the CTA is unclear, or the evaluation window is too short.

Unsubscribe rate by message is your early warning signal. If a specific message in the sequence is driving opt-outs, fix it before it damages your sender reputation.

Revenue per user entering Canvas, for eCommerce and subscription businesses especially, is the ultimate proof of onboarding ROI. This metric ties the Canvas directly to business outcomes and gives you a clear case for investing in further optimization.

Use Braze's Canvas Analytics page and built-in retention reports to track rolling retention for users who moved through the Canvas versus a control group. The delta between those two numbers is the business case for everything you've built.

‍

Frequently Asked Questions

1. How long should a Braze Canvas onboarding journey run?
   For most products, seven days covers the highest-risk churn window without overwhelming users. Complex SaaS or enterprise products where activation takes longer may extend to fourteen or thirty days. Let your activation data guide the window, if 80% of users who ever convert do so within five days, don't run a twenty-one day sequence.
2. Can a user enter a Braze onboarding Canvas more than once?
   Only if you enable re-eligibility, which for onboarding journeys should be set to "Never." Each user should experience onboarding exactly once. If a previously onboarded user becomes dormant, build a separate re-engagement Canvas for that specific lifecycle stage rather than looping them back through onboarding.
3. What channels should I include in a Braze onboarding Canvas?
   Take a cross-channel approach from the start. Email works best for welcome messages and detailed content. In-app messages work best for contextual feature guidance while users are actively in your product. Push notifications work for re-engagement nudges when users are inactive. Use Braze's Intelligent Channel feature to let the platform automatically select the optimal channel per user based on historical engagement data.
4. What is the difference between Braze Action Paths and Audience Paths in a Canvas?
   Action Paths split users based on what they do, specific events or actions they take within a defined evaluation window. Audience Paths split users based on who they are, segment membership, attributes, or behavioral history. Both are essential in a well-architected onboarding Canvas. Use Action Paths to respond to in-journey behavior and Audience Paths to personalize based on user profile and acquisition context.
5. How do I prevent my onboarding Canvas from clashing with other active campaigns?
   Use Braze's built-in frequency capping to limit total message volume across all campaigns per user. For promotional campaigns specifically, add a segment filter that excludes users who entered the onboarding Canvas in the past seven days. During the onboarding window, the onboarding journey should always take priority over promotional or seasonal sends.

How do I know if my Braze onboarding Canvas is actually working?Track activation rate, the percentage of users who complete your defined conversion event within the window, as your primary success metric. Use Braze's Canvas retention reports to compare rolling retention between users who received the Canvas and a control group. A well-built onboarding Canvas should show a measurable lift in both 7-day and 30-day retention compared to users who did not receive it.