Flagship Skill · Upgrade flow design
The upgrade flow design skill.
Upgrades that earn the user's yes by asking at moments of demonstrated value.
A senior product marketing director's playbook for designing free-to-paid conversion flows. Trigger moments, paywall design, value demonstration, win-back flows, churn prevention.
Audience: product marketers, growth marketers, in-house product teams, agencies running SaaS conversion work.
What this skill is for
Growth tooling, grouped by funnel stage.
Upgrade-flow-design opens the Convert cluster: tools that turn engaged users into paying customers. Together with scheduler-and-booking-design, comparison-tool-design, and product-configurator-design, the cluster covers the conversion surface.
Capture
- lead-magnet-design
Gated content that earns the email.
- calculator-design
Interactive calculators with transparent methodology.
- quiz-and-assessment-design
Quizzes producing actionable segmentation.
- multi-step-form-design
Forms broken into coherent steps.
Activate
- onboarding-wizard-design
First-run wizards that engineer the ah-ha moment.
- interactive-product-tour
Contextual tours that surface at moments of friction.
- chatbot-flow-design
Conversational flows grounded in knowledge.
Convert
- scheduler-and-booking-design
Schedulers that earn the better call.
- upgrade-flow-design (this skill)
Free-to-paid flows triggered by demonstrated value.
- comparison-tool-design
Comparison tools with honest recommendations.
- product-configurator-design
Configurators with smart defaults and constraints.
Architect
- funnel-flow-architecture
Cross-tool architecture matching audience and stage.
The keystone distinction
Three positions. Both extremes are failure modes.
Failure mode
Paywall-everywhere
Paywall blocks meaningful product use. Free tier too constrained to demonstrate value. Users churn before reaching the moment that would justify paying.
Failure mode
Free-forever-trap
Generous free tier with no upgrade path that surfaces. Users get everything they need; never see why they would pay. Conversion stays single-digit.
The discipline
Value-triggered-upgrade
Paywall surfaces at moments where the user has demonstrably gotten value. Hit a usage threshold; completed a flow. The upgrade ask is honest about what they get next.
Anatomy of value-triggered-upgrade
Trigger moment, contextual paywall, post-upgrade welcome.
Three zones. Trigger moment (user demonstrated value through repeated use). Contextual paywall (specific connection to what they just did; specific value-prop for what they get next). Post-upgrade (welcome that delivers what was promised).
Trigger moment
User just exported their 5th report
Free tier limit: 5 exports per month. The user demonstrated value (used the export feature 5 times). Now is the moment to surface the upgrade.
Paywall (modal, contextual)
You have used exports 5 times this month
Upgrade to Pro to remove the limit and unlock advanced report customization, scheduled exports, and priority support.
Maybe later
Post-upgrade
Welcome to Pro
Your export limit is removed; advanced customization is now available; scheduled exports are unlocked.
Try a scheduled export now →
The framework
Twelve considerations for upgrade flow design.
- 01The free-tier decision
- 02Value-triggered, not paywall-everywhere or free-forever-trap
- 03Trigger-moment design sound
- 04Paywall presentation matches trigger
- 05Copy connects to the trigger
- 06Upsell, cross-sell, downsell logic
- 07Win-back flows designed
- 08Churn prevention upstream
- 09Plan structure clear
- 10Pricing-page coordinates
- 11Conversion as success metric
- 12Maintenance discipline
What is in the skill
Thirteen sections covered in the body.
01
What this skill covers
Free-to-paid conversion flows in SaaS products. Distinct from lead-magnet-design (top-of-funnel) and funnel-flow-architecture (cross-tool).
02
The free-tier decision
Freemium vs free-trial vs reverse-trial vs no-free.
03
Paywall-everywhere vs free-forever-trap vs value-triggered-upgrade
The keystone framing.
04
Trigger-moment design
Where paywalls earn their interruption. Strong vs weak trigger moments.
05
Paywall presentation
Modal, banner, inline, toast. Copy and value-prop discipline.
06
Upsell vs downsell logic
When primary upgrade declined, secondary paths.
07
Win-back flow design
Lapsed users, downgrades, partial-churn re-engagement.
08
Churn prevention upstream
Preventing churn before the upgrade flow is needed.
09
Plan structure
Tier count, feature gating, audience-fit per tier.
10
Common failure modes
9+ patterns: aggressive paywall + churn, paywalls without value, plan-mismatch + downgrades, win-back without value-prop change.
11
The framework: 12 considerations
Free-tier decision, value-triggered upgrade, trigger moments, paywall presentation, upsell/downsell, win-back, churn prevention, plan structure, pricing-page coordination, conversion metric, maintenance.
12
Reference files
Nine references covering free-tier decision, trigger moments, paywall, upsell-downsell, win-back, churn prevention, plan structure, anti-patterns, failures.
13
Closing: upgrade flows earn revenue when they earn the user's yes
The upgrade flows that compound revenue ask at the moment the user has a reason to say yes.
Reference files
Nine references that go alongside the SKILL.md.
references/free-tier-decision-criteria.md
Freemium, free-trial, reverse trial, no-free. Choice criteria.
references/trigger-moment-design.md
Where paywalls earn their interruption. Strong vs weak trigger moments.
references/paywall-presentation-patterns.md
Modal, banner, inline, toast. Copy and value-prop discipline.
references/upsell-vs-downsell-logic.md
When primary upgrade is declined, secondary paths.
references/win-back-flow-patterns.md
Lapsed users, downgrades, partial-churn re-engagement.
references/churn-prevention-upstream.md
Preventing churn before the upgrade flow is needed.
references/plan-structure-patterns.md
Tier count, feature gating, audience-fit per tier.
references/upgrade-flow-anti-patterns.md
The patterns that look like upgrade flows but degrade trust.
references/common-upgrade-failures.md
9+ failure patterns with diagnoses and cures.
Pairs with these platforms
Three platforms with upgrade-flow-relevant workflows.
The skill is platform-agnostic. These platforms ship workflows that fit upgrade-flow programs: PostHog (trigger moment instrumentation), Mixpanel (cohort and retention analysis), Notion (plan structure documentation).
Bridges to other skills
Five sister skills that compose with upgrade flows.
Adjacent: top-of-funnel
lead-magnet-designLead-magnet-design is top-of-funnel email capture. Upgrade-flow-design is free-to-paid conversion in-product.
Architecture wrapper
funnel-flow-architectureFunnel-flow-architecture is the cross-tool funnel. Upgrade-flow-design is the upgrade flow specifically.
Pricing-page copy
landing-page-copyPricing-page copy lives downstream of plan-structure decisions made here.
Engineering handoff
pm-spec-writingSpec for engineers building the upgrade flow.
Validation layer
experiment-designExperiment-design tests upgrade flow changes rigorously.
Open source under MIT
Read the SKILL.md on GitHub.
The skill source lives in the rampstackco/claude-skills repository. MIT licensed.
Frequently asked questions.
- How is upgrade-flow-design different from lead-magnet-design?
- Lead-magnet-design is top-of-funnel email capture. Upgrade-flow-design is free-to-paid conversion in-product. Different funnel position, different audience commitment level.
- What is value-triggered-upgrade?
- Paywall surfaces at moments where the user has demonstrably gotten value. Hit a usage threshold, completed a flow, demonstrated they are getting the product's promise. The upgrade ask is honest about what they get next.
- Why is paywall-everywhere a problem?
- Paywall blocks meaningful product use; free tier too constrained to demonstrate value. Users churn before reaching the moment that would justify paying. Conversion suffers despite aggressive paywalling.
- What is free-forever-trap?
- Generous free tier with no upgrade path that ever surfaces. Users get everything they need; never see why they would pay. Conversion stays at single-digit percentages indefinitely.
- How do you decide between freemium and free-trial?
- Freemium when network effects matter or free users contribute value. Free-trial when value is clear within trial period and audience commits time. Reverse-trial as alternative; no-free for enterprise. Different free-tier structures warrant different upgrade flows.
- What conversion metric matters most?
- Not just paywall display rate; downstream conversion to paid is the metric. Some teams optimize aggressive paywalls that look like they convert, while retention drops. Track conversion plus retention; aggressive conversion may produce buyer's remorse.