Upsell & Expansion with Braze

Why Most Upsell Programs Fail Before They Start

Most teams treat upsell as a campaign. They pick a segment, write a few emails, and schedule them for the end of the month. The result is predictable: low conversion, high unsubscribes, and a sales team that stops trusting the data.

The problem is timing. Upgrade intent has a short half-life. A user who hits a plan limit on Tuesday and gets your upsell email on Friday is already frustrated, not primed. Braze is built around real-time event triggers, which means you can catch that moment when it actually happens — not when your batch job runs.

This guide walks through a practical implementation for identifying upgrade-ready users and delivering the right offer, at the right time, through the right channel.

---

How Braze Approaches Upsell and Expansion

Braze gives you three core capabilities that matter for upsell:

• Real-time event tracking via the Braze SDK or REST API
• Cross-channel orchestration through Canvas Flow
• Behavioral segmentation using custom attributes, events, and purchase data

The architecture works like this: you define behavioral signals that indicate upgrade intent, pipe those events into Braze, build a Canvas that responds to them, and deliver personalized offers across email, push, in-app messages, and content cards.

---

Step 1: Define Your Upgrade-Ready Signals

Before touching Braze, you need a clear answer to one question: what does an upgrade-ready user actually do?

Common signals by product type:

• Seat-limited SaaS: User invites a collaborator but hits the team member cap
• Usage-limited tools: User reaches 80% or 100% of their monthly quota (API calls, exports, storage)
• Feature-gated products: User attempts to access a premium feature and gets blocked
• Engagement-based: User logs in 15+ days in a 30-day period on a free plan

Pick two or three signals. More than that and you'll over-trigger and dilute the experience.

---

Step 2: Instrument the Events in Braze

Use the Braze SDK or REST API to log custom events when a signal fires. Each event should carry properties that personalize the downstream message.

Example event for a usage threshold:

```json

{

"name": "reached_usage_limit",

"properties": {

"current_plan": "free",

"limit_type": "api_calls",

"usage_percent": 95,

"recommended_plan": "pro"

}

}

```

Also update custom attributes on the user profile:

• `current_plan` — string
• `usage_percent` — number
• `feature_blocked_count` — number (increment each time a user hits a gate)
• `last_limit_hit_date` — date

These attributes power your segment filters and enable Liquid personalization inside messages.

---

Step 3: Build Your Upsell Canvas in Canvas Flow

Canvas Flow is Braze's journey builder. For upsell, you want an Action-Based Canvas — one that enters users when a specific event fires, not on a schedule.

Entry Setup

• Entry type: Action-Based
• Trigger event: Your custom event (e.g., `reached_usage_limit`)
• Entry schedule: Allow re-entry after 30 days so users who hit limits multiple months in a row stay in the flow

Canvas Structure

Build the Canvas in distinct steps:

1. Audience split — Separate free plan users from low-tier paid users. The offer and urgency differ significantly.
2. In-app message (immediate) — Deliver a contextual upgrade prompt the moment the limit is hit. This is your highest-intent touchpoint.
3. Wait step — 1 hour
4. Email step — Send a detailed comparison of their current plan vs. the recommended upgrade, including specific numbers pulled from their profile via Liquid.
5. Decision split — Did they start a trial or upgrade within 48 hours? If yes, exit them. If no, continue.
6. Push or Content Card — 48-hour follow-up with social proof or a time-limited incentive.
7. Sales hand-off step — For high-value accounts (filter by `account_value` attribute or company size), trigger a webhook to your CRM to create a sales task.

Personalization with Liquid

Inside your email or in-app message body:

```

You've used {{custom_attribute.${usage_percent}}}% of your {{custom_attribute.${limit_type}}} limit this month.

Upgrading to {{event_properties.${recommended_plan}}} gives you 10x the capacity — starting today.

```

This makes the message specific to their actual situation, not generic.

---

Step 4: Segment for Proactive Expansion

Not every upsell opportunity starts with a limit hit. Some users are power users who haven't discovered what they're missing.

Build Segment Extensions in Braze for proactive targeting:

• Users on free plans with 10+ sessions in the last 14 days
• Users who have triggered 3+ feature-discovery events but never accessed premium features
• Users whose `feature_blocked_count` attribute is greater than 0 but who haven't seen an upgrade prompt in 60 days

Run these segments into a separate Scheduled Canvas — weekly or biweekly — with educational content that leads toward an upgrade CTA rather than a hard sell.

---

Step 5: Close the Loop with Conversion Tracking

Set up Conversion Events on your Canvas to measure what actually matters:

• Primary: `subscription_upgraded` custom event
• Secondary: `trial_started` event
• Tertiary: Email click on upgrade CTA

Without conversion tracking, you'll optimize for opens and clicks and wonder why revenue isn't moving.

Use Braze's Campaign Analytics and Canvas Analytics to compare conversion rates across entry sources, channels, and message variants. Run A/B tests on the in-app message copy and the email subject line — not both at the same time.

---

Limitations to Know Before You Build

Braze is strong on timing and channel delivery. It has real gaps you should plan around.

• No native predictive scoring: Braze does not have a built-in propensity model for upgrade likelihood. You'll need to bring scores in from an external tool (like your data warehouse or a third-party ML model) as a custom attribute.
• Limited revenue data natively: Braze has a `purchase` event object, but it's not a billing system. Sync your subscription and MRR data in from Stripe or your data warehouse to make segmentation accurate.
• No built-in CRM handoff UI: The webhook step works, but you're building and maintaining that integration yourself. Salesforce and HubSpot connections require configuration and ongoing maintenance.
• Canvas analytics are message-level, not revenue-level: You'll see conversion events but not dollar amounts unless you build that attribution externally.

---

Frequently Asked Questions

How do I prevent users from getting upsell messages too frequently?

Use Canvas re-eligibility settings to control frequency at the journey level, and add a Global Control Group or suppression segment for users who have received an upsell message in the last 30 days. You can also create a custom attribute like `last_upsell_shown_date` and filter it in your entry audience.

Can Braze handle upsell for B2B products where multiple users share one account?

Partially. Braze is user-centric, not account-centric. You can work around this by storing account-level data as custom attributes on each user profile, but you won't get true account-level orchestration out of the box. For complex B2B expansion motions, consider whether a tool with account-level objects is a better fit, or use Braze alongside a CRM that handles the account layer.

What's the difference between using a Campaign versus a Canvas for upsell?

Use Canvas Flow for upsell. Campaigns are single-message sends. Upsell requires multi-step sequences with branching logic, timing delays, and conversion checks. Canvas is built for exactly that. A campaign can't exit a user when they convert mid-sequence.

How do I test whether the upsell program is working without exposing everyone to it?

Use Braze's built-in Global Control Group to hold out a percentage of users from all Canvases. This gives you a clean baseline to compare against. Alternatively, set up a variant within the Canvas itself with a "no message" branch representing 10-20% of entrants. Either approach gives you lift data you can trust.