Monetization Design
Purpose
Design the monetization architecture for a product, including pricing tier structure, paywall placement strategy, subscription infrastructure, and upgrade flow design.
Inputs
- Product feature set (what exists, what's being built)
- Target user segments and willingness-to-pay estimates
- Competitive pricing landscape
- Existing billing infrastructure (Stripe, RevenueCat, etc.)
- App Store / Play Store requirements for in-app purchases
Process
Step 1: Define Value Metrics
Identify what users pay for:
- Usage-based: API calls, storage, messages, seats
- Feature-based: Advanced features, integrations, priority support
- Outcome-based: Projects, exports, reports generated
- Choose the metric that scales with the value the user receives
Step 2: Design Tier Structure
Create a pricing ladder:
- Free tier: Generous enough to create habit and demonstrate value
- Pro tier: For power users and small teams — the "sweet spot"
- Enterprise tier: For organizations — custom pricing, SSO, audit logs
- Apply anchoring: the Pro tier should look like a great deal compared to Enterprise
- Apply decoy effect if appropriate: a tier that makes the target tier look better
Step 3: Design Paywall Placement
Determine where paywalls appear:
- Feature gating: Advanced features locked behind upgrade
- Usage limits: Free tier gets N units/month, Pro gets unlimited
- Soft paywalls: Show the feature, let them try it, then gate on save/export
- Hard paywalls: Block access entirely until upgrade
- Rule: Paywalls should appear when users want more, not when they want basic
Step 4: Design Upgrade Flow
Create the conversion experience:
- Trigger moment: User hits a limit or discovers a locked feature
- Value presentation: Show what they'll get (not just what they're paying)
- Pricing page: Clear comparison table, recommended tier highlighted
- Checkout flow: Minimize steps — ideally 1-2 clicks from trigger to purchase
- Trial option: 7-14 day free trial with full access, credit card optional vs required
Step 5: Design Subscription Infrastructure
Technical architecture:
- Payment provider: Stripe, RevenueCat, Paddle, or platform-native (App Store, Play Store)
- Entitlement system: How the app checks what the user has access to
- Webhook handling: Subscription created, renewed, cancelled, payment failed
- Grace period: What happens when payment fails (dunning flow)
- Platform compliance: App Store requirements for subscription management
Step 6: Design Retention Mechanics
Reduce subscription churn:
- Cancellation flow: Ask why, offer alternatives (pause, downgrade, discount)
- Win-back offers: Discount email after cancellation
- Annual discount: Incentivize annual plans (typically 20% discount)
- Usage reinforcement: Show users the value they've received ("You saved 10 hours this month")
Output Format
# Monetization Architecture
## Value Metric
**Primary metric:** [What users pay for]
**Scaling:** [How it grows with usage]
## Tier Structure
| | Free | Pro ($X/mo) | Enterprise |
|---|------|------------|------------|
| [Feature 1] | Limited | Unlimited | Unlimited |
| [Feature 2] | No | Yes | Yes |
| [Feature 3] | No | No | Yes |
| Support | Community | Email | Dedicated |
## Paywall Map
| Feature/Limit | Type | Trigger | User Experience |
|--------------|------|---------|-----------------|
| [Feature] | Soft | Usage limit hit | Show result, gate export |
| [Feature] | Hard | Feature tap | Upgrade modal with trial |
## Upgrade Flow
1. User hits [trigger]
2. [Inline upgrade prompt / modal / pricing page]
3. [Plan selection with trial option]
4. [Checkout — X steps]
5. [Success confirmation + unlock]
## Subscription Infrastructure
**Provider:** [Stripe / RevenueCat / etc.]
**Entitlement check:** [How the app verifies access]
**Dunning flow:** [What happens on payment failure]
## Retention Strategy
| Churn Signal | Intervention | Timing |
|-------------|-------------|--------|
| Cancellation initiated | Exit survey + discount offer | Immediate |
| Payment failed | Dunning email sequence | Day 1, 3, 7 |
Quality Checks
Evolution Notes
1---2name: monetization-design3description: Pricing tiers, subscription architecture, and paywall strategy4---56# Monetization Design78## Purpose910Design the monetization architecture for a product, including pricing tier structure, paywall placement strategy, subscription infrastructure, and upgrade flow design.1112## Inputs1314- Product feature set (what exists, what's being built)15- Target user segments and willingness-to-pay estimates16- Competitive pricing landscape17- Existing billing infrastructure (Stripe, RevenueCat, etc.)18- App Store / Play Store requirements for in-app purchases1920## Process2122### Step 1: Define Value Metrics2324Identify what users pay for:25- **Usage-based:** API calls, storage, messages, seats26- **Feature-based:** Advanced features, integrations, priority support27- **Outcome-based:** Projects, exports, reports generated28- Choose the metric that scales with the value the user receives2930### Step 2: Design Tier Structure3132Create a pricing ladder:33- **Free tier:** Generous enough to create habit and demonstrate value34- **Pro tier:** For power users and small teams — the "sweet spot"35- **Enterprise tier:** For organizations — custom pricing, SSO, audit logs36- Apply anchoring: the Pro tier should look like a great deal compared to Enterprise37- Apply decoy effect if appropriate: a tier that makes the target tier look better3839### Step 3: Design Paywall Placement4041Determine where paywalls appear:42- **Feature gating:** Advanced features locked behind upgrade43- **Usage limits:** Free tier gets N units/month, Pro gets unlimited44- **Soft paywalls:** Show the feature, let them try it, then gate on save/export45- **Hard paywalls:** Block access entirely until upgrade46- **Rule:** Paywalls should appear when users want *more*, not when they want *basic*4748### Step 4: Design Upgrade Flow4950Create the conversion experience:51- **Trigger moment:** User hits a limit or discovers a locked feature52- **Value presentation:** Show what they'll get (not just what they're paying)53- **Pricing page:** Clear comparison table, recommended tier highlighted54- **Checkout flow:** Minimize steps — ideally 1-2 clicks from trigger to purchase55- **Trial option:** 7-14 day free trial with full access, credit card optional vs required5657### Step 5: Design Subscription Infrastructure5859Technical architecture:60- **Payment provider:** Stripe, RevenueCat, Paddle, or platform-native (App Store, Play Store)61- **Entitlement system:** How the app checks what the user has access to62- **Webhook handling:** Subscription created, renewed, cancelled, payment failed63- **Grace period:** What happens when payment fails (dunning flow)64- **Platform compliance:** App Store requirements for subscription management6566### Step 6: Design Retention Mechanics6768Reduce subscription churn:69- **Cancellation flow:** Ask why, offer alternatives (pause, downgrade, discount)70- **Win-back offers:** Discount email after cancellation71- **Annual discount:** Incentivize annual plans (typically 20% discount)72- **Usage reinforcement:** Show users the value they've received ("You saved 10 hours this month")7374## Output Format7576```markdown77# Monetization Architecture7879## Value Metric80**Primary metric:** [What users pay for]81**Scaling:** [How it grows with usage]8283## Tier Structure84| | Free | Pro ($X/mo) | Enterprise |85|---|------|------------|------------|86| [Feature 1] | Limited | Unlimited | Unlimited |87| [Feature 2] | No | Yes | Yes |88| [Feature 3] | No | No | Yes |89| Support | Community | Email | Dedicated |9091## Paywall Map92| Feature/Limit | Type | Trigger | User Experience |93|--------------|------|---------|-----------------|94| [Feature] | Soft | Usage limit hit | Show result, gate export |95| [Feature] | Hard | Feature tap | Upgrade modal with trial |9697## Upgrade Flow981. User hits [trigger]992. [Inline upgrade prompt / modal / pricing page]1003. [Plan selection with trial option]1014. [Checkout — X steps]1025. [Success confirmation + unlock]103104## Subscription Infrastructure105**Provider:** [Stripe / RevenueCat / etc.]106**Entitlement check:** [How the app verifies access]107**Dunning flow:** [What happens on payment failure]108109## Retention Strategy110| Churn Signal | Intervention | Timing |111|-------------|-------------|--------|112| Cancellation initiated | Exit survey + discount offer | Immediate |113| Payment failed | Dunning email sequence | Day 1, 3, 7 |114```115116## Quality Checks117118- [ ] Free tier is generous enough to demonstrate value and create habit119- [ ] Paywall placement occurs at "want more" moments, not "need basic" moments120- [ ] Upgrade flow is 2 clicks or fewer from trigger to checkout121- [ ] Subscription infrastructure handles renewal, cancellation, and payment failure122- [ ] App Store / Play Store subscription requirements are met (if applicable)123- [ ] Retention mechanics include cancellation flow and win-back strategy124125## Evolution Notes126<!-- Observations appended after each use -->