Paywall & Upgrade Screen CRO

A Claude Code skill that optimizes in-app paywalls and upgrade flows to convert free users to paid, or upgrade existing users to higher tiers. Focuses on timing, messaging, and design to present upgrade opportunities at moments of peak perceived value.

When to Use This Skill

Choose Paywall Upgrade CRO when:

• Your free-to-paid conversion rate is below expectations
• You're designing a paywall for a freemium product
• You want to optimize upsell flows for existing paying customers
• You need to A/B test different upgrade prompts
• Users hit limits but don't convert — they just leave

Consider alternatives when:

• You need to optimize the initial signup/onboarding (use an onboarding CRO skill)
• You want to redesign your pricing page (use a pricing strategy skill)
• You need overall marketing strategy (use a marketing strategy skill)

Quick Start

Copy
# Install the skill
claude install paywall-upgrade-complete

# Audit your current paywall
claude "Our freemium app shows an upgrade modal when users hit 5 projects. Only 2% convert. Here's the modal design: [describe]. How do I improve it?"

# Design a new upgrade flow
claude "Design a paywall strategy for a note-taking app where free users get 50 notes and paid users get unlimited"

# Plan upgrade triggers
claude "What are the best moments to show upgrade prompts in a team collaboration tool?"

Core Concepts

Upgrade Trigger Timing

The most important factor in paywall conversion is when you show it, not just how it looks.

Trigger Type	Description	Conversion Rate
Value Moment	User just experienced a win	Highest (3-8%)
Limit Hit	User reached a usage cap	Medium (1-4%)
Feature Discovery	User tries a premium feature	Medium (1-3%)
Time-Based	After N days of active use	Low-Medium (0.5-2%)
Cold Prompt	Random or session-based prompt	Lowest (<0.5%)

Paywall Design Patterns

Soft Paywall:
  → Show what's behind the gate (blurred/preview)
  → Let users experience partial value first
  → Best for: content apps, analytics tools

Hard Paywall:
  → Block access completely until upgrade
  → Show clear before/after comparison
  → Best for: critical features, export/download

Metered Paywall:
  → Allow N free uses, then require upgrade
  → Users experience full value before paying
  → Best for: API tools, generation tools, search tools

Contextual Upsell:
  → Appear inline where premium features would help
  → Non-intrusive, feels helpful not pushy
  → Best for: complex tools with many premium features

Conversion Psychology at the Paywall

Principle	Application
Loss Aversion	Show what they'll lose access to, not just what they'll gain
Endowment Effect	Let users create with premium features, then gate saving/exporting
Social Proof	Show how many users upgraded at this exact point
Anchoring	Display annual price alongside monthly to make monthly look small
Urgency	Limited-time discount for first upgrade attempt

Configuration

Parameter	Type	Default	Description
product_type	string	"saas"	Product type: saas, mobile_app, content, developer_tool
pricing_model	string	"freemium"	Model: freemium, free_trial, metered, feature_gated
current_conversion	number	0	Current free-to-paid conversion percentage
free_tier_limits	object	{}	Current free tier limitations
price_point	number	0	Monthly price for first paid tier

Best Practices

1. Time the ask after a value moment — Show the upgrade prompt right after the user accomplishes something meaningful. They just completed a project? Great time to say "Unlock unlimited projects." Don't interrupt users mid-task.

2. Show, don't tell — Instead of listing premium features in text, let users briefly experience them. A blurred preview of an analytics dashboard is more compelling than bullet points about "advanced analytics."

3. Make the free tier genuinely useful — If the free tier is too restricted, users leave before reaching a value moment. If it's too generous, they never need to upgrade. Find the balance where free users get hooked on the core value.

4. Reduce upgrade friction — Pre-fill payment forms, offer multiple payment methods, and allow instant access after payment. Every extra click loses 10-20% of potential converters.

5. A/B test the trigger, not just the design — Testing different upgrade modal designs matters less than testing when the modal appears. Test different trigger moments and you'll see dramatically different conversion rates.

Common Issues

Users hit the limit and churn instead of upgrading — Your free tier limit is either too generous (users got everything they needed) or the perceived value gap between free and paid is too small. Increase the value of paid features or adjust limits.

Upgrade modal annoys users — Show it less frequently but at better moments. One well-timed prompt after a value moment converts better than five random prompts. Also, always provide a clear dismiss option.

High upgrade rate but high churn — Users are converting on impulse but not finding lasting value. Make sure your paid tier delivers on what the upgrade prompt promised. Follow up with onboarding specific to paid features.