HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Plan price increase: Communicating the change

Optimize your subscription price change communication strategy using Recurly. Learn how to build an multi-touch announcement timeline, customize native email templates with dynamic merge tokens, and leverage pre-renewal webhooks to seamlessly integrate with your external ESP to maintain high retention and prevent support volume spikes.

Upcoming: Join our CSMs for a live pricing strategy session. Register now →
Acquire Acquire • Plan price increase

Communicating the change

What to say, when to say it, and how to use Recurly's notification tools to reach every subscriber at the right moment.

Navigation Menu

Notification timeline

A well-timed sequence does three things: gives subscribers enough runway to make a decision, prevents a single-day support spike, and reinforces your value rationale at each touchpoint.

Day 0

Initial announcement — 30–90 days before the change

Your primary notification. Explain the why, state the new price, give the effective date. This is the most important message in the sequence — give it the most attention. Personalize with the subscriber's current plan name and price where possible.

Day 14

Reminder — for subscribers who haven't engaged

A shorter follow-up for subscribers who didn't open or act on the first email. One paragraph restating the change and the effective date. Include a link to your FAQ or support page if you've created one.

Pre-renewal

Final notice — close to the subscriber's renewal date

A brief confirmation sent near each subscriber's individual renewal date — not on a fixed calendar day. Keep it factual: their subscription renews on [date] at [new price]. Use Recurly's renewal.scheduled prerenewal webhook to trigger this automatically via your ESP. See Recurly Docs: Prerenewal notifications.

Email template — Subscription change

The "Subscription Change" email template is triggered when a subscription is modified. It can be customized to communicate your plan price change in a meaningful way. You'll find it here: Configuration → Email Templates → Subscription. Feel free to use the sample messaging provided below, complete with accurate tokens, and tailor it to your brand.

The feature bullets should be specific and demonstrate value. Generic language like, "We've been working hard," may be too vague to your customers.

Tokens for ramp pricing models

If you are using ramp pricing, you can replace the price entries with {{subscription_next_ramp_interval_price}} for the new price and {{subscription_next_ramp_interval_start_date}} for the effective date, rather than entering those values manually.

Email template — Term renewal reminder

Make sure your customers get a final notification before their term renewal takes place. This message is short by design. Subscribers already know the change is coming — this is a confirmation, not a pitch.

You'll find the "Term renewal reminder" template in Configuration → Email Templates → Subscription Renewal.

Recurly notification tools

You have two paths for delivering these notifications — Recurly's native email system or your own ESP via webhooks. Both work; the right choice depends on how much design control you need.

Using Recurly's native email templates

Go to Configuration → Email Templates to customize subscription event emails. Templates must be enabled in two places: globally under Email Templates, and at the plan level — check both if emails aren't sending. See Recurly Docs: Email templates for the correct variable syntax — Recurly uses its own parameter format, not dot-notation.

Using webhooks with your ESP

If you use Braze, Iterable, Klaviyo, or similar, subscribe to the subscription.updated webhook event to trigger migration notifications, and the renewal.scheduled prerenewal webhook for the final notice. See Recurly Docs: Subscription notifications for the full list of valid event names.