--- title: "Upgrade Prompt Timing — Expansion Growth Tactic" description: "Gates upgrade prompts by lifecycle stage and behavior, because 41 percent of upgrades happen in month zero and the timing rules invert outside that window." canonical: "https://churnkey.co/growth/library/upgrade-prompt-timing" category: "growth" related: - /growth/library/index.html.md - /growth/library/methodology.html.md - /tools/dollar-retention-rate-calculator.html.md last_updated: "2026-06-09" --- # Upgrade Prompt Timing Gates upgrade prompts by lifecycle stage and behavior, because 41 percent of upgrades happen in month zero and the timing rules invert outside that window. - **Stage:** Expansion - **Evidence grade:** validated (replicated across many companies) - **Evidence:** 41 percent of upgrades happen in month 0 - **Trigger type:** Threshold - **Channels:** in-app ## What is it? Upgrades are not spread evenly across a subscription’s life: 41 percent of them happen in month zero, while the subscriber is still sizing the product against their problem. The behaviors that predict an upgrade in that first month read differently afterward. Outside the window, the timing rules invert, and a prompt that converts a week-two subscriber gets ignored at month six. This tactic gates every upgrade prompt by lifecycle stage and behavior together. Rather than one upgrade playbook for everyone, it applies the month-zero rules inside the month-zero window and the post-window rules everywhere else, so the prompt appears only when the rules say this subscriber, at this stage, is in an upgrade posture. ## When it fires Inside month zero, the tactic watches for early expansion behavior (plan-limit exploration, billing-page visits, advanced feature usage) and shows the prompt in-app while the subscriber’s plan decision is still live. The first month is the dense part of the distribution, and the tactic treats it as prime upgrade territory rather than a no-pitch grace period. Outside the window, the bar rises. The tactic requires the post-window behavioral signals before any prompt fires, because the same surface-level activity no longer carries the same meaning. The result is fewer prompts later in life, each with a much better claim to the subscriber’s attention. ## What the evidence shows The 41 percent month-zero concentration comes from upgrade-timing analysis across 110M+-subscriptions, a structural feature of how subscribers buy rather than one product’s quirk. The window where plans are still being decided is where a plurality of upgrade decisions land. The case for precision is what the rest of the data shows: among subscribers who change plans at all, downgrades outnumber upgrades nearly two to one. Plan changes are not a one-way escalator, which is why prompts blasted on a calendar are wasteful. The tactic exists to put the upgrade question in front of the subscribers and moments where the answer is plausibly yes. ## How it runs In production, the tactic tracks each subscriber’s lifecycle stage, applies the matching rule set, and resolves prompt timing per subscriber. Acceptance applies the plan change in the billing provider. A dismissal feeds back into the rules as evidence the gate fired early. Guardrails keep the prompt scarce: hard frequency caps, automatic suppression around any save or recovery activity, and a standing preference for missing a marginal upgrade over training subscribers to ignore upgrade prompts. ## Run it with the Churnkey MCP This tactic runs via the Churnkey MCP. Connect it to your favorite AI agent and it reads your own usage and billing data, then recommends and runs the plays most likely to move your LTV — starting with whether this one fits. **Trigger:** A subscriber’s behavior crosses the upgrade-readiness rules for their current lifecycle stage: the month-zero rule set inside the first month, the inverted post-window rule set afterward. **Surface:** In-app upgrade prompt at the subscriber’s next moment of natural product use. **Guardrails:** - Stage gating: never apply month-zero timing rules outside the month-zero window. The rule sets are separate by design. - Rate limit: at most one upgrade prompt per subscriber per 60 days. Never re-prompt within 30 days of a dismissal. - Collision avoidance: suppress while any Cancel Flow, Payment Recovery sequence, or other offer is active for the subscriber. - Prompt scarcity: when readiness is ambiguous, hold the prompt. A missed marginal upgrade costs less than a subscriber trained to ignore upgrade prompts. **Evidence:** Month zero carries 41 percent of all upgrades, and the behavioral rules that predict an upgrade invert outside that window, validated across upgrade-timing analysis using a dataset consisting of over 110M subscriptions. Among plan changers broadly, downgrades outnumber upgrades nearly two to one, which is the case for gated precision over calendar-driven prompting. **How to run it:** 1. Segment each subscriber by lifecycle stage, with month zero as its own window. 2. Derive two rule sets from historical upgrade outcomes: the behaviors that precede month-zero upgrades, and the distinct behaviors that precede post-window upgrades. 3. Evaluate every active subscriber against the rule set for their stage. Recompute on each new usage event. 4. When the rules pass, render the upgrade prompt in-app at the next moment of natural use, with the target plan resolved from observed usage. 5. On acceptance, apply the plan change in the billing provider. On dismissal, start the 30-day cooldown and log the miss against the rule set. 6. Track prompt conversion by lifecycle stage and dismissal rate. Retune each rule set against its own window’s outcomes, never against the pooled average. Install the MCP server: ```bash npm install -g @churnkey/mcp ``` The full reference is in the [Churnkey MCP docs](https://docs.churnkey.co/data-integrations/mcp). ## Related - [Growth Tactics Library](/growth/library/index.html.md) — The full register of graded growth plays. - [How Tactics Are Graded](/growth/library/methodology.html.md) — The four-grade evidence ladder behind this grade. - [Dollar retention rate calculator](/tools/dollar-retention-rate-calculator.html.md) — Related calculator.