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-design3department: "herald"4description: "Pricing tiers, subscription architecture, and paywall strategy"5version: 16triggers:7 - "pricing"8 - "subscription"9 - "freemium"10 - "paywall"11 - "billing"12 - "revenue"13 - "monetization"14 - "trial"15 - "upsell"16 - "plan"17---1819# Monetization Design2021## Purpose2223Design the monetization architecture for a product, including pricing tier structure, paywall placement strategy, subscription infrastructure, and upgrade flow design.2425## Inputs2627- Product feature set (what exists, what's being built)28- Target user segments and willingness-to-pay estimates29- Competitive pricing landscape30- Existing billing infrastructure (Stripe, RevenueCat, etc.)31- App Store / Play Store requirements for in-app purchases3233## Process3435### Step 1: Define Value Metrics3637Identify what users pay for:38- **Usage-based:** API calls, storage, messages, seats39- **Feature-based:** Advanced features, integrations, priority support40- **Outcome-based:** Projects, exports, reports generated41- Choose the metric that scales with the value the user receives4243### Step 2: Design Tier Structure4445Create a pricing ladder:46- **Free tier:** Generous enough to create habit and demonstrate value47- **Pro tier:** For power users and small teams — the "sweet spot"48- **Enterprise tier:** For organizations — custom pricing, SSO, audit logs49- Apply anchoring: the Pro tier should look like a great deal compared to Enterprise50- Apply decoy effect if appropriate: a tier that makes the target tier look better5152### Step 3: Design Paywall Placement5354Determine where paywalls appear:55- **Feature gating:** Advanced features locked behind upgrade56- **Usage limits:** Free tier gets N units/month, Pro gets unlimited57- **Soft paywalls:** Show the feature, let them try it, then gate on save/export58- **Hard paywalls:** Block access entirely until upgrade59- **Rule:** Paywalls should appear when users want *more*, not when they want *basic*6061### Step 4: Design Upgrade Flow6263Create the conversion experience:64- **Trigger moment:** User hits a limit or discovers a locked feature65- **Value presentation:** Show what they'll get (not just what they're paying)66- **Pricing page:** Clear comparison table, recommended tier highlighted67- **Checkout flow:** Minimize steps — ideally 1-2 clicks from trigger to purchase68- **Trial option:** 7-14 day free trial with full access, credit card optional vs required6970### Step 5: Design Subscription Infrastructure7172Technical architecture:73- **Payment provider:** Stripe, RevenueCat, Paddle, or platform-native (App Store, Play Store)74- **Entitlement system:** How the app checks what the user has access to75- **Webhook handling:** Subscription created, renewed, cancelled, payment failed76- **Grace period:** What happens when payment fails (dunning flow)77- **Platform compliance:** App Store requirements for subscription management7879### Step 6: Design Retention Mechanics8081Reduce subscription churn:82- **Cancellation flow:** Ask why, offer alternatives (pause, downgrade, discount)83- **Win-back offers:** Discount email after cancellation84- **Annual discount:** Incentivize annual plans (typically 20% discount)85- **Usage reinforcement:** Show users the value they've received ("You saved 10 hours this month")8687## Output Format8889```markdown90# Monetization Architecture9192## Value Metric93**Primary metric:** [What users pay for]94**Scaling:** [How it grows with usage]9596## Tier Structure97| | Free | Pro ($X/mo) | Enterprise |98|---|------|------------|------------|99| [Feature 1] | Limited | Unlimited | Unlimited |100| [Feature 2] | No | Yes | Yes |101| [Feature 3] | No | No | Yes |102| Support | Community | Email | Dedicated |103104## Paywall Map105| Feature/Limit | Type | Trigger | User Experience |106|--------------|------|---------|-----------------|107| [Feature] | Soft | Usage limit hit | Show result, gate export |108| [Feature] | Hard | Feature tap | Upgrade modal with trial |109110## Upgrade Flow1111. User hits [trigger]1122. [Inline upgrade prompt / modal / pricing page]1133. [Plan selection with trial option]1144. [Checkout — X steps]1155. [Success confirmation + unlock]116117## Subscription Infrastructure118**Provider:** [Stripe / RevenueCat / etc.]119**Entitlement check:** [How the app verifies access]120**Dunning flow:** [What happens on payment failure]121122## Retention Strategy123| Churn Signal | Intervention | Timing |124|-------------|-------------|--------|125| Cancellation initiated | Exit survey + discount offer | Immediate |126| Payment failed | Dunning email sequence | Day 1, 3, 7 |127```128129## Quality Checks130131- [ ] Free tier is generous enough to demonstrate value and create habit132- [ ] Paywall placement occurs at "want more" moments, not "need basic" moments133- [ ] Upgrade flow is 2 clicks or fewer from trigger to checkout134- [ ] Subscription infrastructure handles renewal, cancellation, and payment failure135- [ ] App Store / Play Store subscription requirements are met (if applicable)136- [ ] Retention mechanics include cancellation flow and win-back strategy137138## Evolution Notes139<!-- Observations appended after each use -->