chunkydotdev/onboarding-emails

Onboarding Emails

Design welcome sequences and activation emails that get new users to their first moment of value.

When to use this skill

• Building a welcome email sequence for a new SaaS product or service
• Users are signing up but not completing setup or reaching activation
• Designing trial-to-paid conversion email flows
• Deciding between time-based drip sequences and behavior-triggered emails
• Improving an existing onboarding sequence that has poor activation rates
• Segmenting onboarding emails by plan, role, or use case
• Adding stall detection to re-engage users who drop off mid-onboarding

Related skills

• transactional-email - receipts and auth emails that sit alongside onboarding
• email-sequences - general drip campaign architecture (onboarding is a specific case)
• email-copywriting - writing the actual email content
• template-design - HTML templates that render correctly everywhere
• notification-design - product notification patterns that complement onboarding
• suppression-lists - managing opt-outs so you stop when users say stop
• ab-testing - testing subject lines and content within your sequence

---

The goal of onboarding emails

The point is not open rates. The point is activation - getting users to the moment where they experience your product's value. Every email in the sequence should push toward a single action that moves the user closer to that moment.

Before writing a single email, define your activation milestone. What does a user need to do before they "get it"? Examples:

• Developer tool: Make a successful API call
• Project management app: Create a project and invite a team member
• Email platform: Send the first email
• Analytics product: Install the tracking snippet and see their first dashboard

Everything in your onboarding sequence should point toward that milestone.

---

Sequence structure

The 5-email onboarding framework

Most successful onboarding sequences have 4-7 emails sent over 1-2 weeks. Here is a proven 5-email structure that works across most SaaS products:

| # | Email | Trigger | Goal | |---|-------|---------|------| | 1 | Welcome + quick win | Immediately on signup | Get user to complete one small action in the first session | | 2 | Core feature tutorial | 24h after signup OR after completing quick win | Show the primary value feature | | 3 | Stall recovery / next step | 48h after signup if no activation, skip if activated | Re-engage stalled users or push activated users further | | 4 | Social proof + advanced use case | Day 5-7 | Show what power users do, build confidence | | 5 | Trial expiry / upgrade nudge | 3 days before trial ends | Create urgency, summarize value received |

Shorter sequences for simpler products

If your product has a fast time-to-value (under 5 minutes to first success), a 3-email sequence works better:

1. Welcome + guided setup (immediate) - get them into the product
2. Value reinforcement (Day 2-3) - show what they accomplished or push stalled users
3. Conversion (before trial ends) - upgrade prompt with usage summary

Longer sequences for complex products

Enterprise or multi-stakeholder products often need 7+ emails to cover:

• Admin vs end-user setup paths
• Integration guides for specific tools
• Team onboarding (the person who signed up is rarely the only user)
• Compliance or security setup requirements
• Champion enablement (giving the buyer internal selling materials)

---

Behavioral triggers vs time-based drips

This is the single most impactful decision in onboarding email design. Behavior-triggered sequences outperform time-based drips by roughly 30% on activation, and can see 3x higher open rates because the emails are relevant to what the user just did (or failed to do).

Time-based (simple, lower performance)

Every user gets the same emails on the same schedule regardless of what they have done:

Day 0: Welcome
Day 1: Feature tour
Day 3: Social proof
Day 7: Upgrade nudge
Day 13: Trial expiry warning

Use time-based when: you are just starting, have no event tracking, or your product has a very uniform user journey.

Behavior-triggered (higher performance, more setup)

Emails fire based on product events:

user.signed_up        -> Welcome email (immediate)
setup.completed       -> "Nice, here's what to try next"
setup.stalled (24h)   -> "Need help finishing setup?"
first_value.achieved  -> "You did it - here's what power users do"
trial.expiring (3d)   -> "Your trial ends soon" (only if not converted)

The key advantage: if a user activates in 10 minutes, they never get the "need help?" email. If they stall for 3 days, they get targeted help at the point where they are stuck.

Hybrid approach (recommended)

Combine both. Use behavioral triggers for milestone emails and time-based fallbacks for users who have not triggered any events:

Event: user.signed_up
  -> Send welcome immediately

Event: setup.completed (within 48h)
  -> Send "great, here's the next step"
  -> Cancel the Day 2 stall-recovery email

Fallback: 48h after signup, no setup.completed event
  -> Send stall-recovery email

Event: first_value.achieved
  -> Send activation celebration
  -> Cancel the Day 5 feature highlight

Fallback: Day 7, no first_value.achieved
  -> Send "here's what you're missing" with tutorial link

The hybrid model gets you 80% of the behavioral benefit with much simpler implementation. You need event tracking for key milestones (signup, setup complete, first value moment, conversion) and time-based fallbacks for everything else.

---

The welcome email

The welcome email has a 50-70% open rate - far higher than any other email in the sequence. Do not waste it.

What to include

• Confirmation that signup worked. Users worry about this more than you think.
• One clear CTA to the first action. Not three CTAs, not a feature tour. One button: "Create your first project" or "Install the snippet" or "Send a test email."
• Set expectations. Tell them what emails are coming. "Over the next week, I'll send you 4 short emails to help you get started." This reduces unsubscribes on subsequent emails.
• Reply prompt. "Hit reply and tell me what you're trying to accomplish" - this gives you segmentation data and trains Gmail that your emails are wanted.

What to leave out

• Feature lists. They just signed up; they already saw your marketing site.
• Sales language. No "upgrade now" in the welcome email.
• Multiple CTAs. Every additional CTA reduces the click rate on all of them.
• Long product tours. Link to docs or videos for people who want depth, but keep the email itself short.

Timing

Send within 5 minutes of signup. 74% of users expect the welcome email immediately. Every minute of delay reduces open rates. If your system takes longer than 10 minutes to send a welcome email, fix that before optimizing anything else.

Example welcome email structure

Subject: You're in - here's your first step

Hi [name],

Welcome to [product]. Your account is ready.

The fastest way to see what [product] can do:

[CTA button: "Create your first [thing]"]

It takes about 2 minutes. Once you do, you'll see [specific value outcome].

Over the next week, I'll send you a few short emails with tips to get
the most out of [product]. You can unsubscribe anytime.

Questions? Just reply to this email.

[Sender name], [title] at [product]

---

Stall detection and recovery

The highest-converting onboarding emails are not the welcome messages. They are the stall-recovery emails - the ones that reach users who started but got stuck.

Identifying stalls

A stall is when a user completed one milestone but has not reached the next within an expected timeframe. Define stall thresholds for each milestone:

| Milestone | Expected completion | Stall threshold | Recovery action | |-----------|-------------------|-----------------|-----------------| | Account creation -> First login | Minutes | 24 hours | "Your account is waiting" | | First login -> Setup complete | 1 session | 48 hours | "Finish setup in 3 steps" | | Setup complete -> First value action | 1-3 days | 72 hours | "Here's a 2-minute walkthrough" | | First value action -> Repeated use | 3-7 days | 7 days | "Here's what power users do" | | Trial active -> Paid conversion | Varies | 3 days before expiry | Trial expiry warning |

Writing effective stall-recovery emails

Bad stall recovery: "Just checking in! Haven't seen you in a while."

Good stall recovery: "You created your account but haven't sent your first email yet. Here's a 2-minute walkthrough that covers the three steps."

The difference: specificity. Reference exactly where they stopped and give them a direct path to the next step.

Rules for stall-recovery emails:

1. Name the stall. "You completed X but haven't done Y yet."
2. Remove the friction. If they stalled, something was hard. Provide a shortcut, a video, or a simplified path.
3. Single CTA. Do not give stalled users more choices. Give them one clear action.
4. Offer help. "Reply to this email and I'll help you get set up" works better than linking to a help center.
5. Do not guilt-trip. "We miss you!" and "Don't forget about us!" are about you, not them.

Stall detection with policy enforcement

When you are using automated or agent-driven systems to detect stalls and send recovery emails, policy enforcement prevents over-sending. Key safeguards:

• Per-recipient cooldowns prevent sending multiple recovery emails when several stall checks fire at once. A 24-hour minimum cooldown between onboarding emails is standard.
• Deduplication keys ensure the same recovery email is never sent twice. Use a key like onboarding:step3:user123 so that retries and duplicate event firings are safe.
• Fatigue scoring considers the total send volume to a recipient. If a user has received 3+ emails in 7 days, further onboarding emails should be held regardless of stall state. A fatigue score above 40 (on a 0-100 scale) suggests reducing frequency; above 70 means stop sending entirely.
• Suppression checks catch users who have bounced, complained, or unsubscribed. No stall recovery email should bypass suppression lists.

---

Segmentation

Sending the same onboarding sequence to every user is the second-biggest mistake after not sending onboarding emails at all. Segment by the dimensions that actually change what you should say.

Segment by plan or tier

Different plans imply different needs and value thresholds:

| Plan | Onboarding focus | Conversion goal | |------|-----------------|-----------------| | Free trial | Get to activation milestone fast | Convert to paid before trial ends | | Freemium | Show value of paid features | Upgrade when they hit limits | | Paid (self-serve) | Ensure full setup, reduce early churn | Expand to higher tier | | Enterprise | Admin setup, team rollout, integrations | Successful deployment |

Segment by role or job function

Capture role at signup (even a single dropdown helps). Tailor the core feature you highlight:

• Developer -> API docs, SDKs, integration guides
• Marketing -> Templates, audience tools, analytics
• Manager -> Team features, dashboards, permissions
• Founder/generalist -> Quick-start, most popular use case

Segment by use case or intent

If you ask "What do you want to accomplish?" during signup, use the answer to route users into different sequences:

• "Send transactional emails" -> Skip marketing features, go straight to API setup
• "Run email campaigns" -> Skip API docs, show the visual editor
• "Replace our current provider" -> Migration guide, import tools, comparison content

Segment by behavior (dynamic)

After the welcome email, let behavior drive segmentation:

• Fast activators (completed setup in first session) -> Skip tutorial emails, send advanced content
• Slow explorers (logged in multiple times, haven't activated) -> Send simplified guides, offer a call
• Ghost signups (signed up, never logged in) -> Re-engagement sequence starting at 48 hours

When segmentation is not worth it

If you have fewer than 100 signups per month, do not build complex segments. Write one good sequence, measure where users drop off, and iterate. Segmentation pays off at scale; premature segmentation adds maintenance burden without enough data to optimize.

---

Trial-to-paid conversion

The trial expiry sequence is a mini-campaign within your onboarding. It deserves separate attention because the dynamics are different from educational onboarding emails.

Conversion email timeline

For a 14-day trial:

| Day | Email | Tone | |-----|-------|------| | Day 10 | Usage summary + value reminder | Informational | | Day 12 | "Your trial ends in 2 days" + upgrade CTA | Urgency | | Day 14 | "Trial ended" + limited-time offer or downgrade option | Last chance | | Day 17 | "We saved your data" + reactivation link | Win-back |

What works in conversion emails

• Show usage data. "You've created 12 projects and invited 3 team members" is more compelling than "You'll love our premium features."
• Quantify the value. "Your team saved an estimated 8 hours this week using [product]" (if you can calculate this).
• Address the objection. The most common reason people don't convert is not price - it is that they have not experienced enough value. The conversion email should push them to the value moment, not just pitch the price.
• Offer a graceful downgrade. "Not ready to upgrade? Your free plan keeps [limited feature set]" reduces churn to zero better than a hard paywall.
• Limited extension. Offering a 7-day extension to users who engaged but did not convert can recover 15-25% of otherwise lost trials.

What kills conversions

• Sending upgrade emails to users who never activated. They will not pay for something they have not used. Send them back to activation emails instead.
• Generic "Your trial is ending" without any personalization. These get ignored.
• Too many conversion emails. More than 3-4 in the final days feels pushy.
• No email at all after trial expires. The win-back email (Day 17) recovers a meaningful percentage of churned trials.

---

Email content patterns

The single-CTA rule

Every onboarding email should have exactly one primary call-to-action. Research consistently shows that adding a second CTA reduces clicks on both. If you need to link to multiple resources, put them below the fold as text links, not buttons.

Plain text vs HTML

For onboarding emails, plain-text-style emails (or minimal HTML) outperform heavily designed templates. Reasons:

• They feel personal, like they came from a human colleague
• They are less likely to be clipped by Gmail (which clips messages over ~102KB)
• They render consistently across every email client
• They bypass image-blocking on corporate email systems

Reserve designed templates for transactional emails (receipts, confirmations). Onboarding emails should read like a helpful note from a real person.

Send from a person, not a brand

"Sarah from Acme" gets higher open rates than "Acme Team" or "[email protected]". Use a real person's name and a reply-able address. Replies to onboarding emails are a strong engagement signal and help with inbox placement.

Subject line patterns that work for onboarding

| Pattern | Example | Why it works | |---------|---------|-------------| | Direct benefit | "Send your first email in 2 minutes" | Clear value, specific time commitment | | Question | "What are you trying to build?" | Curiosity, feels conversational | | Progress update | "You're 1 step away from [outcome]" | Completeness bias, specific | | Social proof | "How [company] set up in 10 minutes" | Credibility, benchmarking | | Help offer | "Need help with [specific step]?" | Relevant to stalled users |

Avoid: "Welcome to [product]!" as a subject line. It says nothing about what is inside. The welcome email subject should state the first action: "Your account is ready - create your first [thing]."

---

Metrics that matter

Primary metrics

| Metric | What it measures | Good benchmark | |--------|-----------------|----------------| | Activation rate | % of signups reaching the value moment | 40-60% | | Time to activation | Hours/days from signup to first value moment | Under 48 hours | | Trial-to-paid conversion | % of trial users who convert | 15-25% (no CC), 40-60% (CC required) | | Onboarding completion rate | % of users who reach the final milestone | Above 40% is OK, above 55% is strong |

Email-specific metrics

| Metric | What it measures | Good benchmark | |--------|-----------------|----------------| | Welcome email open rate | First-impression engagement | 50-70% | | Sequence open rate | Sustained engagement across all emails | 40%+ | | CTA click rate | Action taken from email | 15%+ | | Unsubscribe rate per email | Fatigue or relevance issues | Under 0.5% per email |

The engagement multiplier

The key diagnostic metric: compare activation rates of email-engaged users (opened or clicked at least one onboarding email) vs non-engaged users. If email-engaged users activate at 2x or higher the rate of non-engaged users, your onboarding emails are working. If the multiplier is below 1.5x, your emails are not driving behavior - they are just accompanying it.

What to optimize first

Optimize in this order (highest impact first):

1. Welcome email CTA click rate. This is your best email with your most engaged audience. If the click rate is low, the problem is the CTA, not the audience.
2. Stall-recovery email send rate. Are you detecting stalls and sending recovery emails? Many teams build the sequence but skip stall detection.
3. Activation rate by segment. Find which user segments activate at low rates and build targeted content for them.
4. Trial-to-paid drop-off point. If users activate but do not convert, the problem is pricing or packaging, not onboarding. If they do not activate, the problem is onboarding.

---

Common mistakes

1. Sending the same sequence to everyone

A developer and a marketing manager have completely different setup paths. At minimum, segment by role or use case. One generic sequence alienates most of your audience.

2. Too many emails too fast

More than one email per day during onboarding triggers fatigue and unsubscribes. Space emails at least 24 hours apart, and respect a weekly cap of 3 during the onboarding period. Watch your fatigue score - if a user has received 3+ emails in 7 days with no engagement, back off.

3. Feature tours instead of outcomes

"Did you know we have a Kanban board?" is a feature tour. "Create your first project board in 2 minutes" is an outcome. Users do not care about features. They care about what they can accomplish.

4. No stall detection

If you only send time-based emails, you are sending "try feature X" to users who already used it and ignoring users who are stuck. Even basic stall detection (checking whether the user logged in within 48 hours of signup) dramatically improves relevance.

5. Skipping the welcome email

Some teams delay the welcome email to batch-process it, or bury it in a queue behind lower-priority messages. The welcome email has the highest open rate of any email you will ever send to that user. Send it immediately - within 5 minutes of signup. Prioritize it above everything else in your send queue.

6. Hard paywall at trial expiry with no warning

Users who hit a sudden paywall feel tricked. Send at least two warning emails before the trial ends, and always offer a downgrade path. The post-expiry win-back email is critical too - many users intend to upgrade but forget.

7. "Just checking in" stall recovery

Vague check-in emails have near-zero click rates. Name the specific step the user has not completed and provide a direct link to complete it. "You haven't sent your first email yet - here's a 2-minute walkthrough" converts. "Just checking in!" does not.

8. Ignoring engagement signals

Continuing to send onboarding emails to users who never open them damages your sender reputation. After 3 consecutive unopened emails, either reduce frequency or move the user to a different channel (in-app messages, push notifications). Do not keep hammering an unresponsive inbox.

9. No deduplication on event-triggered emails

If your system sends emails based on product events and the same event fires twice (webhook retries, duplicate API calls), the user gets two identical emails. Always use deduplication keys combining the email type, step identifier, and user ID.

10. Treating onboarding as marketing

Onboarding emails should use your transactional sending infrastructure, not your marketing email system. They should be sent from a reply-able address, not no-reply@. They should bypass marketing suppression rules (a user who unsubscribed from your newsletter still needs their password reset and onboarding emails). Check your email provider's classification - most support marking emails as transactional to ensure priority delivery.

---

Implementation checklist

1. Define your activation milestone. What specific user action indicates they have experienced your product's value?
2. Map your onboarding milestones. Identify 4-6 events between signup and activation. Define what "stalled" means for each one.
3. Choose your trigger model. Time-based for simplicity, behavioral for performance, hybrid for the best balance.
4. Write 4-6 emails. Welcome, core feature, stall recovery, social proof, trial conversion. Each with a single CTA.
5. Set up segmentation. At minimum, segment by plan type. Add role or use-case segmentation as your volume grows.
6. Implement stall detection. Check for users who completed step N but have not reached step N+1 within your threshold window.
7. Add policy safeguards. Per-recipient cooldowns (24h minimum), deduplication keys per step, fatigue monitoring, suppression list checks.
8. Measure activation, not opens. Track whether email-engaged users activate at a higher rate than non-engaged users. If the multiplier is below 1.5x, your emails need work.
9. Iterate on stall points. Find where users drop off, improve the recovery email for that step, and test whether the drop-off decreases.

---

References

• Encharge: The Onboarding Email Sequence We Use to Get 40%+ Open Rates
• Encharge: Time-Based vs Action-Based Onboarding Emails
• Encharge: Create a Trigger-Based Email Onboarding Flow
• ProductLed: SaaS Onboarding Email Best Practices
• Userpilot: Onboarding Email Sequence for Fast User Activation
• Userpilot: 12 Onboarding Emails to Learn From
• Userlist: 6 Best Trigger-Based Email Marketing Campaigns for SaaS
• MailerLite: SaaS Email Onboarding Guide
• ProsperStack: The First 30 Days - Crafting a Winning Onboarding Email Sequence
• Appcues: 8 User Onboarding Metrics and KPIs
• Chameleon: User Onboarding Metrics, KPIs, and Benchmarks
• Amplitude: Time to Value - The Key to Driving User Retention
• CopyHackers: SaaS Onboarding Email Sequence That Tripled Conversions
• molted.email - email platform with built-in policy enforcement (cooldowns, deduplication, fatigue scoring, suppression) and journey orchestration for automated onboarding sequences