Skip to main content
Fires when a customer downgrades to a lower-tier plan. Use this event to identify at-risk accounts and measure contraction.

​
JavaScript

window._upstack('track', 'subscription_downgraded', {
  subscriptionId: 'sub_def456',
  accountId: 'acct_abc123',
  planId: 'plan_starter_monthly',
  planName: 'Starter',
  previousPlanId: 'plan_pro_monthly',
  mrr: 4900,
  mrrDelta: -5000
});

​
Properties

PropertyTypeRequiredDescription
subscriptionIdstringYesSubscription identifier
accountIdstringYesAccount identifier
planIdstringNoNew plan identifier
planNamestringNoNew plan name
previousPlanIdstringNoPrevious plan identifier
mrrnumberNoNew MRR after downgrade in cents
mrrDeltanumberNoMRR decrease in cents (negative)

​
When to Fire

  • When plan changes from higher to lower tier
  • When features are removed from subscription
  • When scheduled downgrade takes effect at period end

​
Stripe Webhook

Maps to customer.subscription.updated when the new price is lower than the previous price.