Subscription Lifecycle: Trial, Churn, Win-back skill

When the user wants to optimize their subscription business end-to-end — from trial start through renewal, cancellation, and win-back.

by appeeky·MIT license·★ 2,152 Stars on the repo·GitHub ↗

Use now

Files of Subscription Lifecycle: Trial, Churn, Win-back

appeeky/main1 file shown
SKILL.md
Show the full text207 lines

Subscription Lifecycle

You optimize every stage of the subscription journey: trial → paid → renewal → cancellation recovery → win-back.

The Subscription Lifecycle

Install → Trial start → [Trial period] → Conversion → Renewal → ... → Cancel → Win-back
            ↓                               ↓              ↓           ↓
         No convert                    Voluntary       Involuntary   Lapsed
         (nurture)                     (exit survey)   (dunning)     (campaign)

Key Metrics at Each Stage

Stage Metric Formula Benchmark
Trial Trial start rate Trials / Downloads > 20%
Trial Trial-to-paid Conversions / Trials 25–40% strong
Retention Month 1 renewal M1 renewals / Subscribers > 70%
Retention Month 6 renewal M6 renewals / Subscribers > 50%
Churn Monthly churn Lost subs / Start subs < 5% good; < 2% excellent
Revenue MRR Active subs × monthly price —
Revenue LTV ARPU / Monthly churn rate —
Recovery Dunning recovery Recovered / Failed payments > 30%
Win-back Resubscribe rate Returns / Lapsed 5–15%

Stage 1 — Trial Optimization

Trial Length
App Type Recommended trial Notes
Simple utility 3–7 days Value obvious quickly
Health/fitness 7–14 days Habit formation needs time
Productivity 7–14 days Workflow integration
Education 7–14 days First lesson completion
Entertainment 7 days Binge behavior

Test: Monthly apps with a 7-day trial vs. 14-day trial — conversion rate may drop slightly but LTV often increases.

Trial Nurture Sequence

Send in-app (or push) messages during the trial to drive activation:

Day 0: Welcome — "Your trial has started. Here's how to get the most from it."
Day 1: Core feature highlight — "Try [key feature] today"
Day 3: Progress / social proof — "Users who do X get 3× better results"
Day 5 (7-day trial): Urgency — "2 days left in your trial"
Day 6: Value recap — "Here's what you've done / could do with premium"
Day 7: Last day — "Your trial ends today"

Rule: Messages should show value, not just create pressure.

Trial End — Conversion Moment

At trial end, show a paywall that:

  • Recaps what the user achieved during the trial
  • Shows the most-used premium features
  • Offers 3 plan options (monthly / annual / lifetime if applicable)
  • Highlights savings on annual ("Save 40%")

See monetization-strategy for paywall design details.

Stage 2 — Reducing Voluntary Churn

Why Users Cancel (and How to Fix It)
Reason Signal Fix
Forgot they subscribed Low sessions, no activation Improve onboarding + notification strategy
Not enough value Low feature usage Push underused high-value features
Too expensive Price sensitivity Introduce lower-tier or pause option
Problem with app 1-star reviews Fix the bug, reply to reviews
Found alternative — Monitor competitor installs
Seasonal use Churns at same time yearly Offer a pause option
The Cancellation Flow

When a user initiates cancellation (iOS — ManagedSubscriptionGroup):

  1. Offer a pause before full cancel: "Pause for 1–3 months instead of cancelling"
  2. Show value recap: "You've used [feature] X times this month"
  3. Offer a discount: Only as last resort — 20–30% off for 3 months
  4. Exit survey: Always ask "Why are you cancelling?" (1 tap, not an essay)

Cancellation exit survey options:

  • Too expensive
  • Not using it enough
  • Missing a feature I need
  • Switching to a competitor
  • Technical issues
  • Just taking a break
Engagement Signals to Watch

Users at high churn risk:

  • Sessions < 1 per week (down from higher baseline)
  • Core feature not used in 14+ days
  • Push notifications disabled
  • Last session > 7 days ago

Trigger a re-engagement push or in-app message before they cancel.

Stage 3 — Involuntary Churn (Failed Payments)

Involuntary churn accounts for 20–40% of all subscription cancellations.

Dunning Strategy
Day Action
0 Payment fails silently — Apple/Google retry
3 Apple/Google retry #2
7 Apple/Google retry #3 — show in-app "Update payment method" banner
10 Send push: "Your subscription couldn't be renewed — tap to update"
14 Grace period ends — subscription suspended
15 Final in-app message: "Reactivate to keep access"

Grace period:

  • iOS: 6 days (configurable up to 16 in App Store Connect)
  • Android: 3 days (configurable)

Maximize grace period length — every extra day recovers more subscribers.

RevenueCat Integration

RevenueCat handles dunning automatically. Key settings:

  • Enable Billing Retry (iOS) / Account Hold (Android)
  • Configure grace period to maximum allowed
  • Use RevenueCat webhooks to trigger in-app messaging at each failure event

See revenuecat.md integration guide.

Stage 4 — Win-Back Campaigns

Target lapsed subscribers (cancelled or expired in last 30–90 days).

Win-Back Offer Ladder

Start with the softest offer; escalate only if no response:

Week 1 after lapse:  "We miss you" — highlight new features added since they left
Week 3:              "Come back for 30% off your first month back"
Week 6:              "3 months at 50% off — best offer we'll make"
Week 12+:            Archive — low conversion probability
Win-Back Channels
Channel How
Push notification In-app if app still installed
Email If email was collected
Apple Win-Back Offer Native iOS win-back offer in StoreKit 2
Paid retargeting Meta/Google retargeting to lapsed subscriber list
StoreKit 2 Win-Back Offers (iOS 18+)

Apple natively supports win-back subscription offers for lapsed subscribers:

  • Set up in App Store Connect → Subscriptions → Win-Back Offers
  • Presented automatically in the App Store to eligible lapsed users
  • No additional code needed beyond StoreKit 2 integration

Output Format

Subscription Health Report
Lifecycle Metrics ([period]):

Trial start rate:    [X]%  (benchmark: >20%)
Trial conversion:    [X]%  (benchmark: 25-40%)
M1 renewal:          [X]%  (benchmark: >70%)
Monthly churn:       [X]%  (benchmark: <5%)
Dunning recovery:    [X]%  (benchmark: >30%)
Win-back rate:       [X]%  (benchmark: 5-15%)

LTV (estimated):    $[N]
MRR:                $[N]

Top issues:
1. [Stage] — [metric] is [X]% vs benchmark [Y]% — [recommended fix]
2. [Stage] — [metric] is [X]% vs benchmark [Y]% — [recommended fix]

Priority action:
[Single highest-leverage change to implement this week]
  • monetization-strategy — Paywall design, pricing tiers, trial setup
  • retention-optimization — Engagement strategy to reduce voluntary churn
  • app-analytics — Track the metrics above with Firebase + RevenueCat
  • onboarding-optimization — Fix early-stage drop-off that prevents trial starts
  • rating-prompt-strategy — Satisfied subscribers are your best raters
1---
2name: subscription-lifecycle
3description: When the user wants to optimize their subscription business end-to-end — from trial start through renewal, cancellation, and win-back. Use when the user mentions "subscription lifecycle", "trial conversion", "churn", "cancellation", "win-back", "lapsed subscribers", "dunning", "billing retry", "grace period", "renewal rate", "subscriber LTV", or "resubscribe". For paywall design and pricing strategy, see monetization-strategy. For subscription analytics dashboards, see app-analytics.
4metadata:
5 version: 1.0.0
6---
7 
8# Subscription Lifecycle
9 
10You optimize every stage of the subscription journey: trial → paid → renewal → cancellation recovery → win-back.
11 
12## The Subscription Lifecycle
13 
14```
15Install → Trial start → [Trial period] → Conversion → Renewal → ... → Cancel → Win-back
16 ↓ ↓ ↓ ↓
17 No convert Voluntary Involuntary Lapsed
18 (nurture) (exit survey) (dunning) (campaign)
19```
20 
21## Key Metrics at Each Stage
22 
23| Stage | Metric | Formula | Benchmark |
24|-------|--------|---------|-----------|
25| Trial | Trial start rate | Trials / Downloads | > 20% |
26| Trial | Trial-to-paid | Conversions / Trials | 25–40% strong |
27| Retention | Month 1 renewal | M1 renewals / Subscribers | > 70% |
28| Retention | Month 6 renewal | M6 renewals / Subscribers | > 50% |
29| Churn | Monthly churn | Lost subs / Start subs | < 5% good; < 2% excellent |
30| Revenue | MRR | Active subs × monthly price | — |
31| Revenue | LTV | ARPU / Monthly churn rate | — |
32| Recovery | Dunning recovery | Recovered / Failed payments | > 30% |
33| Win-back | Resubscribe rate | Returns / Lapsed | 5–15% |
34 
35## Stage 1 — Trial Optimization
36 
37### Trial Length
38 
39| App Type | Recommended trial | Notes |
40|----------|------------------|-------|
41| Simple utility | 3–7 days | Value obvious quickly |
42| Health/fitness | 7–14 days | Habit formation needs time |
43| Productivity | 7–14 days | Workflow integration |
44| Education | 7–14 days | First lesson completion |
45| Entertainment | 7 days | Binge behavior |
46 
47**Test:** Monthly apps with a 7-day trial vs. 14-day trial — conversion rate may drop slightly but LTV often increases.
48 
49### Trial Nurture Sequence
50 
51Send in-app (or push) messages during the trial to drive activation:
52 
53```
54Day 0: Welcome — "Your trial has started. Here's how to get the most from it."
55Day 1: Core feature highlight — "Try [key feature] today"
56Day 3: Progress / social proof — "Users who do X get 3× better results"
57Day 5 (7-day trial): Urgency — "2 days left in your trial"
58Day 6: Value recap — "Here's what you've done / could do with premium"
59Day 7: Last day — "Your trial ends today"
60```
61 
62**Rule:** Messages should show value, not just create pressure.
63 
64### Trial End — Conversion Moment
65 
66At trial end, show a paywall that:
67- Recaps what the user achieved during the trial
68- Shows the most-used premium features
69- Offers 3 plan options (monthly / annual / lifetime if applicable)
70- Highlights savings on annual ("Save 40%")
71 
72See `monetization-strategy` for paywall design details.
73 
74## Stage 2 — Reducing Voluntary Churn
75 
76### Why Users Cancel (and How to Fix It)
77 
78| Reason | Signal | Fix |
79|--------|--------|-----|
80| Forgot they subscribed | Low sessions, no activation | Improve onboarding + notification strategy |
81| Not enough value | Low feature usage | Push underused high-value features |
82| Too expensive | Price sensitivity | Introduce lower-tier or pause option |
83| Problem with app | 1-star reviews | Fix the bug, reply to reviews |
84| Found alternative | — | Monitor competitor installs |
85| Seasonal use | Churns at same time yearly | Offer a pause option |
86 
87### The Cancellation Flow
88 
89When a user initiates cancellation (iOS — `ManagedSubscriptionGroup`):
90 
911. **Offer a pause** before full cancel: "Pause for 1–3 months instead of cancelling"
922. **Show value recap**: "You've used [feature] X times this month"
933. **Offer a discount**: Only as last resort — 20–30% off for 3 months
944. **Exit survey**: Always ask "Why are you cancelling?" (1 tap, not an essay)
95 
96**Cancellation exit survey options:**
97- Too expensive
98- Not using it enough
99- Missing a feature I need
100- Switching to a competitor
101- Technical issues
102- Just taking a break
103 
104### Engagement Signals to Watch
105 
106Users at high churn risk:
107- Sessions < 1 per week (down from higher baseline)
108- Core feature not used in 14+ days
109- Push notifications disabled
110- Last session > 7 days ago
111 
112Trigger a re-engagement push or in-app message before they cancel.
113 
114## Stage 3 — Involuntary Churn (Failed Payments)
115 
116Involuntary churn accounts for **20–40%** of all subscription cancellations.
117 
118### Dunning Strategy
119 
120| Day | Action |
121|-----|--------|
122| 0 | Payment fails silently — Apple/Google retry |
123| 3 | Apple/Google retry #2 |
124| 7 | Apple/Google retry #3 — show in-app "Update payment method" banner |
125| 10 | Send push: "Your subscription couldn't be renewed — tap to update" |
126| 14 | Grace period ends — subscription suspended |
127| 15 | Final in-app message: "Reactivate to keep access" |
128 
129**Grace period:**
130- iOS: 6 days (configurable up to 16 in App Store Connect)
131- Android: 3 days (configurable)
132 
133Maximize grace period length — every extra day recovers more subscribers.
134 
135### RevenueCat Integration
136 
137RevenueCat handles dunning automatically. Key settings:
138- Enable Billing Retry (iOS) / Account Hold (Android)
139- Configure grace period to maximum allowed
140- Use RevenueCat webhooks to trigger in-app messaging at each failure event
141 
142See `revenuecat.md` integration guide.
143 
144## Stage 4 — Win-Back Campaigns
145 
146Target lapsed subscribers (cancelled or expired in last 30–90 days).
147 
148### Win-Back Offer Ladder
149 
150Start with the softest offer; escalate only if no response:
151 
152```
153Week 1 after lapse: "We miss you" — highlight new features added since they left
154Week 3: "Come back for 30% off your first month back"
155Week 6: "3 months at 50% off — best offer we'll make"
156Week 12+: Archive — low conversion probability
157```
158 
159### Win-Back Channels
160 
161| Channel | How |
162|---------|-----|
163| Push notification | In-app if app still installed |
164| Email | If email was collected |
165| Apple Win-Back Offer | Native iOS win-back offer in StoreKit 2 |
166| Paid retargeting | Meta/Google retargeting to lapsed subscriber list |
167 
168### StoreKit 2 Win-Back Offers (iOS 18+)
169 
170Apple natively supports win-back subscription offers for lapsed subscribers:
171- Set up in App Store Connect → Subscriptions → Win-Back Offers
172- Presented automatically in the App Store to eligible lapsed users
173- No additional code needed beyond StoreKit 2 integration
174 
175## Output Format
176 
177### Subscription Health Report
178 
179```
180Lifecycle Metrics ([period]):
181 
182Trial start rate: [X]% (benchmark: >20%)
183Trial conversion: [X]% (benchmark: 25-40%)
184M1 renewal: [X]% (benchmark: >70%)
185Monthly churn: [X]% (benchmark: <5%)
186Dunning recovery: [X]% (benchmark: >30%)
187Win-back rate: [X]% (benchmark: 5-15%)
188 
189LTV (estimated): $[N]
190MRR: $[N]
191 
192Top issues:
1931. [Stage] — [metric] is [X]% vs benchmark [Y]% — [recommended fix]
1942. [Stage] — [metric] is [X]% vs benchmark [Y]% — [recommended fix]
195 
196Priority action:
197[Single highest-leverage change to implement this week]
198```
199 
200## Related Skills
201 
202- `monetization-strategy` — Paywall design, pricing tiers, trial setup
203- `retention-optimization` — Engagement strategy to reduce voluntary churn
204- `app-analytics` — Track the metrics above with Firebase + RevenueCat
205- `onboarding-optimization` — Fix early-stage drop-off that prevents trial starts
206- `rating-prompt-strategy` — Satisfied subscribers are your best raters
207 

Discussion

Alternatives

Win back customers before they cancelTell us about your subscription business and why people quit. Get back a ready-to-use plan to keep more customers and recover failed payments.Business & ops · MITCustomer success managerUse this agent when you need to assess customer health, develop retention strategies, identify upsell opportunities, or maximize customer lifetime value. Invoke this agent for account health analysis, churn prevention, product adoption optimization, and customer success planning. Specifically:\\n\\n<example>\\nContext: Customer success team notices a large enterprise customer has reduced usage frequency by 40% over the past month and hasn't engaged in quarterly business reviews.\\nuser: "We're concerned about TechCorp's engagement. Usage is down significantly. Can you assess what's happening and help us develop a retention strategy?"\\nassistant: "I'll analyze TechCorp's health metrics including usage patterns, feature adoption, support interactions, and engagement history. I'll identify specific churn risks, assess whether there are product fit issues or implementation gaps, and develop a targeted intervention plan with clear milestones and success metrics."\\n<commentary>\\nUse customer-success-manager when you need to evaluate at-risk accounts and create proactive retention strategies. This agent analyzes health signals holistically and prescribes specific interventions.\\n</commentary>\\n</example>\\n\\n<example>\\nContext: Product team is rolling out new features and customer success team wants to maximize adoption across the customer base while identifying expansion revenue opportunities.\\nuser: "We're launching three new features next month. How do we ensure our customers actually adopt them? And which customers might be willing to upgrade to higher tiers?"\\nassistant: "I'll segment your customer base by maturity level and current product usage patterns. I'll develop feature-specific adoption strategies for each segment, identify high-value customers ready for expansion conversations, and create a phased rollout plan with success metrics and training resources."\\n<commentary>\\nInvoke this agent when you need to drive adoption of new features or identify expansion opportunities. The agent analyzes customer readiness and creates tailored engagement strategies for different segments.\\n</commentary>\\n</example>\\n\\n<example>\\nContext: Quarterly renewal period is approaching and customer success team wants to prepare for renewal conversations with key accounts and identify which customers are at risk of non-renewal.\\nuser: "We have 40 accounts up for renewal in the next 90 days. Can you help us prepare renewal strategies and flag which ones might be at risk?"\\nassistant: "I'll assess each account's health indicators including NPS, usage trends, executive engagement, feature adoption, and any unresolved issues. I'll prioritize high-risk accounts for intervention, develop renewal talking points based on demonstrated value, and create a pre-renewal engagement plan for each tier of customer."\\n<commentary>\\nUse this agent when renewal periods are approaching or you need to forecast renewal risk. The agent quantifies customer health and develops specific pre-renewal strategies to maximize renewal rates.\\n</commentary>\\n</example>\\n\\nDoes not handle individual support tickets or FAQ/help-center content — hand those to customer-support. Does not own pre-sale technical POC/RFP work — hand that to sales-engineer. Does not finalize pricing or discount decisions — route to the account/deal team. Does not review or negotiate contract/legal terms — route to legal-advisor.Business & ops · MIT/cs:cco-review — CCO Forcing Questions/cs:cco-review <plan> — Retention-obsessed Chief Customer Officer interrogation of any plan that touches customer retention, segmentation, CS team sizing, or CS team hiring. Use when gross retention is slipping, before approving CSM headcount, or when deciding which customer segments to keep or fire. · MITChurn preventionReduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences. Use when designing or optimizing a cancel flow, building save offers, setting up dunning emails, or reducing failed-payment churn. Trigger keywords: cancel flow, churn reduction, save offers, dunning, exit survey, payment recovery, win-back, involuntary churn, failed payments, cancel page. NOT for customer health scoring or expansion revenue — use customer-success-manager for that. · MIT