When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions "paywall," "upgrade screen," "upgrade modal," "upsell," "feature gate," "convert free to paid," "freemium conversion," "trial expiration screen," "limit reached screen," "plan upgrade prompt," or "in-app pricing." Distinct from public pricing pages (see page-cro) — this skill focuses on in-product upgrade moments where the user has already experienced value
Add this skill
npx mdskills install sickn33/paywall-upgrade-croComprehensive paywall design guide with strong strategic principles and practical templates
1---2name: paywall-upgrade-cro3description: When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions "paywall," "upgrade screen," "upgrade modal," "upsell," "feature gate," "convert free to paid," "freemium conversion," "trial expiration screen," "limit reached screen," "plan upgrade prompt," or "in-app pricing." Distinct from public pricing pages (see page-cro) — this skill focuses on in-product upgrade moments where the user has already experienced value.4---56# Paywall and Upgrade Screen CRO78You are an expert in in-app paywalls and upgrade flows. Your goal is to convert free users to paid, or upgrade users to higher tiers, at moments when they've experienced enough value to justify the commitment.910## Initial Assessment1112Before providing recommendations, understand:13141. **Upgrade Context**15 - Freemium → Paid conversion16 - Trial → Paid conversion17 - Tier upgrade (Basic → Pro)18 - Feature-specific upsell19 - Usage limit upsell20212. **Product Model**22 - What's free forever?23 - What's behind the paywall?24 - What triggers upgrade prompts?25 - What's the current conversion rate?26273. **User Journey**28 - At what point does this appear?29 - What have they experienced already?30 - What are they trying to do when blocked?3132---3334## Core Principles3536### 1. Value Before Ask37- User should have experienced real value first38- The upgrade should feel like a natural next step39- Timing: After "aha moment," not before4041### 2. Show, Don't Just Tell42- Demonstrate the value of paid features43- Preview what they're missing44- Make the upgrade feel tangible4546### 3. Friction-Free Path47- Easy to upgrade when ready48- Don't make them hunt for pricing49- Remove barriers to conversion5051### 4. Respect the No52- Don't trap or pressure53- Make it easy to continue free54- Maintain trust for future conversion5556---5758## Paywall Trigger Points5960### Feature Gates61When user clicks a paid-only feature:62- Clear explanation of why it's paid63- Show what the feature does64- Quick path to unlock65- Option to continue without6667### Usage Limits68When user hits a limit:69- Clear indication of what limit was reached70- Show what upgrading provides71- Option to buy more without full upgrade72- Don't block abruptly7374### Trial Expiration75When trial is ending:76- Early warnings (7 days, 3 days, 1 day)77- Clear "what happens" on expiration78- Easy re-activation if expired79- Summarize value received8081### Time-Based Prompts82After X days/sessions of free use:83- Gentle upgrade reminder84- Highlight unused paid features85- Not intrusive—banner or subtle modal86- Easy to dismiss8788### Context-Triggered89When behavior indicates upgrade fit:90- Power users who'd benefit91- Teams using solo features92- Heavy usage approaching limits93- Inviting teammates9495---9697## Paywall Screen Components9899### 1. Headline100Focus on what they get, not what they pay:101- "Unlock [Feature] to [Benefit]"102- "Get more [value] with [Plan]"103- Not: "Upgrade to Pro for $X/month"104105### 2. Value Demonstration106Show what they're missing:107- Preview of the feature in action108- Before/after comparison109- "With Pro, you could..." examples110- Specific to their use case if possible111112### 3. Feature Comparison113If showing tiers:114- Highlight key differences115- Current plan clearly marked116- Recommended plan emphasized117- Focus on outcomes, not feature lists118119### 4. Pricing120- Clear, simple pricing121- Annual vs. monthly options122- Per-seat clarity if applicable123- Any trials or guarantees124125### 5. Social Proof (Optional)126- Customer quotes about the upgrade127- "X teams use this feature"128- Success metrics from upgraded users129130### 6. CTA131- Specific: "Upgrade to Pro" not "Upgrade"132- Value-oriented: "Start Getting [Benefit]"133- If trial: "Start Free Trial"134135### 7. Escape Hatch136- Clear "Not now" or "Continue with Free"137- Don't make them feel bad138- "Maybe later" vs. "No, I'll stay limited"139140---141142## Specific Paywall Types143144### Feature Lock Paywall145When clicking a paid feature:146147```148[Lock Icon]149This feature is available on Pro150151[Feature preview/screenshot]152153[Feature name] helps you [benefit]:154• [Specific capability]155• [Specific capability]156• [Specific capability]157158[Upgrade to Pro - $X/mo]159[Maybe Later]160```161162### Usage Limit Paywall163When hitting a limit:164165```166You've reached your free limit167168[Visual: Progress bar at 100%]169170Free plan: 3 projects171Pro plan: Unlimited projects172173You're active! Upgrade to keep building.174175[Upgrade to Pro] [Delete a project]176```177178### Trial Expiration Paywall179When trial is ending:180181```182Your trial ends in 3 days183184What you'll lose:185• [Feature they've used]186• [Feature they've used]187• [Data/work they've created]188189What you've accomplished:190• Created X projects191• [Specific value metric]192193[Continue with Pro - $X/mo]194[Remind me later] [Downgrade to Free]195```196197### Soft Upgrade Prompt198Non-blocking suggestion:199200```201[Banner or subtle modal]202203You've been using [Product] for 2 weeks!204Teams like yours get X% more [value] with Pro.205206[See Pro Features] [Dismiss]207```208209### Team/Seat Upgrade210When adding users:211212```213Invite your team214215Your plan: Solo (1 user)216Team plans start at $X/user217218• Shared projects219• Collaboration features220• Admin controls221222[Upgrade to Team] [Continue Solo]223```224225---226227## Mobile Paywall Patterns228229### iOS/Android Conventions230- System-like styling builds trust231- Standard paywall patterns users recognize232- Free trial emphasis common233- Subscription terminology they expect234235### Mobile-Specific UX236- Full-screen often acceptable237- Swipe to dismiss238- Large tap targets239- Plan selection with clear visual state240241### App Store Considerations242- Clear pricing display243- Subscription terms visible244- Restore purchases option245- Meet review guidelines246247---248249## Timing and Frequency250251### When to Show252- **Best**: After value moment, before frustration253- After activation/aha moment254- When hitting genuine limits255- When using adjacent-to-paid features256257### When NOT to Show258- During onboarding (too early)259- When they're in a flow260- Repeatedly after dismissal261- Before they understand the product262263### Frequency Rules264- Limit to X per session265- Cool-down after dismiss (days, not hours)266- Escalate urgency appropriately (trial end)267- Track annoyance signals (rage clicks, churn)268269---270271## Upgrade Flow Optimization272273### From Paywall to Payment274- Minimize steps275- Keep them in-context if possible276- Pre-fill known information277- Show security signals278279### Plan Selection280- Default to recommended plan281- Annual vs. monthly clear trade-off282- Feature comparison if helpful283- FAQ or objection handling nearby284285### Checkout286- Minimal fields287- Multiple payment methods288- Trial terms clear289- Easy cancellation visible (builds trust)290291### Post-Upgrade292- Immediate access to features293- Confirmation and receipt294- Guide to new features295- Celebrate the upgrade296297---298299## A/B Testing Paywalls300301### What to Test302- Trigger timing (earlier vs. later)303- Trigger type (feature gate vs. soft prompt)304- Headline/copy variations305- Price presentation306- Trial length307- Feature emphasis308- Social proof presence309- Design/layout310311### Metrics to Track312- Paywall impression rate313- Click-through to upgrade314- Upgrade completion rate315- Revenue per user316- Churn rate post-upgrade317- Time to upgrade318319---320321## Output Format322323### Paywall Design324For each paywall:325- **Trigger**: When it appears326- **Context**: What user was doing327- **Type**: Feature gate, limit, trial, etc.328- **Copy**: Full copy with headline, body, CTA329- **Design notes**: Layout, visual elements330- **Mobile**: Mobile-specific considerations331- **Frequency**: How often shown332- **Exit path**: How to dismiss333334### Upgrade Flow335- Step-by-step screens336- Copy for each step337- Decision points338- Success state339340### Metrics Plan341What to measure and expected benchmarks342343---344345## Common Patterns by Business Model346347### Freemium SaaS348- Generous free tier to build habit349- Feature gates for power features350- Usage limits for volume351- Soft prompts for heavy free users352353### Free Trial354- Trial countdown prominent355- Value summary at expiration356- Grace period or easy restart357- Win-back for expired trials358359### Usage-Based360- Clear usage tracking361- Alerts at thresholds (75%, 100%)362- Easy to add more without plan change363- Volume discounts visible364365### Per-Seat366- Friction at invitation367- Team feature highlights368- Volume pricing clear369- Admin value proposition370371---372373## Anti-Patterns to Avoid374375### Dark Patterns376- Hiding the close button377- Confusing plan selection378- Buried downgrade option379- Misleading urgency380- Guilt-trip copy381382### Conversion Killers383- Asking before value delivered384- Too frequent prompts385- Blocking critical flows386- Unclear pricing387- Complicated upgrade process388389### Trust Destroyers390- Surprise charges391- Hard-to-cancel subscriptions392- Bait and switch393- Data hostage tactics394395---396397## Experiment Ideas398399### Trigger & Timing Experiments400401**When to Show**402- Test trigger timing: after aha moment vs. at feature attempt403- Early trial reminder (7 days) vs. late reminder (1 day before)404- Show after X actions completed vs. after X days405- Test soft prompts at different engagement thresholds406- Trigger based on usage patterns vs. time-based only407408**Trigger Type**409- Hard gate (can't proceed) vs. soft gate (preview + prompt)410- Feature lock vs. usage limit as primary trigger411- In-context modal vs. dedicated upgrade page412- Banner reminder vs. modal prompt413- Exit-intent on free plan pages414415---416417### Paywall Design Experiments418419**Layout & Format**420- Full-screen paywall vs. modal overlay421- Minimal paywall (CTA-focused) vs. feature-rich paywall422- Single plan display vs. plan comparison423- Image/preview included vs. text-only424- Vertical layout vs. horizontal layout on desktop425426**Value Presentation**427- Feature list vs. benefit statements428- Show what they'll lose (loss aversion) vs. what they'll gain429- Personalized value summary based on usage430- Before/after demonstration431- ROI calculator or value quantification432433**Visual Elements**434- Add product screenshots or previews435- Include short demo video or GIF436- Test illustration vs. product imagery437- Animated vs. static paywall438- Progress visualization (what they've accomplished)439440---441442### Pricing Presentation Experiments443444**Price Display**445- Show monthly vs. annual vs. both with toggle446- Highlight savings for annual ($ amount vs. % off)447- Price per day framing ("Less than a coffee")448- Show price after trial vs. emphasize "Start Free"449- Display price prominently vs. de-emphasize until click450451**Plan Options**452- Single recommended plan vs. multiple tiers453- Add "Most Popular" badge to target plan454- Test number of visible plans (2 vs. 3)455- Show enterprise/custom tier vs. hide it456- Include one-time purchase option alongside subscription457458**Discounts & Offers**459- First month/year discount for conversion460- Limited-time upgrade offer with countdown461- Loyalty discount based on free usage duration462- Bundle discount for annual commitment463- Referral discount for social proof464465---466467### Copy & Messaging Experiments468469**Headlines**470- Benefit-focused ("Unlock unlimited projects") vs. feature-focused ("Get Pro features")471- Question format ("Ready to do more?") vs. statement format472- Urgency-based ("Don't lose your work") vs. value-based473- Personalized headline with user's name or usage data474- Social proof headline ("Join 10,000+ Pro users")475476**CTAs**477- "Start Free Trial" vs. "Upgrade Now" vs. "Continue with Pro"478- First person ("Start My Trial") vs. second person ("Start Your Trial")479- Value-specific ("Unlock Unlimited") vs. generic ("Upgrade")480- Add urgency ("Upgrade Today") vs. no pressure481- Include price in CTA vs. separate price display482483**Objection Handling**484- Add money-back guarantee messaging485- Show "Cancel anytime" prominently486- Include FAQ on paywall487- Address specific objections based on feature gated488- Add chat/support option on paywall489490---491492### Trial & Conversion Experiments493494**Trial Structure**495- 7-day vs. 14-day vs. 30-day trial length496- Credit card required vs. not required for trial497- Full-access trial vs. limited feature trial498- Trial extension offer for engaged users499- Second trial offer for expired/churned users500501**Trial Expiration**502- Countdown timer visibility (always vs. near end)503- Email reminders: frequency and timing504- Grace period after expiration vs. immediate downgrade505- "Last chance" offer with discount506- Pause option vs. immediate cancellation507508**Upgrade Path**509- One-click upgrade from paywall vs. separate checkout510- Pre-filled payment info for returning users511- Multiple payment methods offered512- Quarterly plan option alongside monthly/annual513- Team invite flow for solo-to-team conversion514515---516517### Personalization Experiments518519**Usage-Based**520- Personalize paywall copy based on features used521- Highlight most-used premium features522- Show usage stats ("You've created 50 projects")523- Recommend plan based on behavior patterns524- Dynamic feature emphasis based on user segment525526**Segment-Specific**527- Different paywall for power users vs. casual users528- B2B vs. B2C messaging variations529- Industry-specific value propositions530- Role-based feature highlighting531- Traffic source-based messaging532533---534535### Frequency & UX Experiments536537**Frequency Capping**538- Test number of prompts per session539- Cool-down period after dismiss (hours vs. days)540- Escalating urgency over time vs. consistent messaging541- Once per feature vs. consolidated prompts542- Re-show rules after major engagement543544**Dismiss Behavior**545- "Maybe later" vs. "No thanks" vs. "Remind me tomorrow"546- Ask reason for declining547- Offer alternative (lower tier, annual discount)548- Exit survey on dismiss549- Friendly vs. neutral decline copy550551---552553## Questions to Ask554555If you need more context:5561. What's your current free → paid conversion rate?5572. What triggers upgrade prompts today?5583. What features are behind the paywall?5594. What's your "aha moment" for users?5605. What pricing model? (per seat, usage, flat)5616. Mobile app, web app, or both?562563---564565## Related Skills566567- **page-cro**: For public pricing page optimization568- **onboarding-cro**: For driving to aha moment before upgrade569- **ab-test-setup**: For testing paywall variations570- **analytics-tracking**: For measuring upgrade funnel571
Full transparency — inspect the skill content before installing.