SaaS • Downgrades • Retention
How to Configure Downgrade Settings for SaaS Clients
Downgrade Settings in the SaaS Configurator let agencies give SaaS clients a self-service path to move to a lower plan while retaining control over timing and retention offers. Agencies can collect downgrade reasons, optionally present a discount to eligible clients, and review downgrade activity. For eligible SaaS V1 subscriptions, the downgrade lifecycle also determines when Stripe and the corresponding selling-sub-account subscription are synchronized.
What You'll Learn

Learn how to enable self-service downgrades, configure downgrade reasons and retention discounts, understand when a downgrade becomes effective, track activity, and recognize when eligible SaaS V1 subscription synchronization occurs.

Important

Scheduling a downgrade does not immediately change the client's active plan. The client keeps the current plan and features until the scheduled effective date. For an eligible SaaS V1 selling-sub-account subscription, synchronization occurs when the supported downgrade becomes effective.

1

What are Downgrade Settings for SaaS Clients?

Downgrade Settings in the SaaS Configurator control whether sub-account admins can move themselves to a lower-tier SaaS plan. Agencies can enable or disable self-service downgrades, customize the reasons clients choose when downgrading, and optionally present eligible clients with a retention discount before the downgrade is scheduled. This creates a structured downgrade path while preserving visibility into churn reasons and outcomes.

2

Key Benefits of Configuring Downgrade Settings for SaaS Clients

A structured downgrade experience gives clients more control while helping agencies preserve revenue, understand churn, and maintain predictable billing behavior. Configuring these settings before clients need them also reduces manual support work during plan changes.

Self-Service Control: Clients can initiate an eligible downgrade from their Billing area without contacting support.
Churn Insight: Configurable downgrade reasons help identify recurring pricing, adoption, or usability concerns.
Revenue Protection: Eligible V1 clients can be presented with an optional discount offer before the downgrade is scheduled.
Predictable Billing: This downgrade flow schedules the lower plan for the next billing cycle instead of changing the subscription mid-cycle.
Auditability: Activity Logs provide visibility into downgrade attempts, deflections, reasons, plans, and users.
3

Behavior & Billing Rules

Downgrade timing determines when billing and feature access actually change. Understanding these rules helps agencies explain the client experience accurately and distinguish a scheduled downgrade from one that has already become effective.

  • Monthly discount duration: For eligible monthly subscriptions, the retention discount applies for the number of months configured by the agency.
  • Annual discount duration: For eligible annual subscriptions, the discount applies for one year.
  • Scheduled effective date: The downgrade takes effect at the start of the next billing cycle.
  • No mid-cycle proration: This scheduled downgrade flow does not create a mid-cycle refund or partial charge.
  • Access until the change: Clients keep their current-plan features until the scheduled effective date.
  • Keep My Plan: Clients can cancel a scheduled downgrade before its effective date and remain on the current plan.
  • Upgrades remain available: Eligible clients can still access supported upgrade options from Billing.

Retention outcome: If a client accepts the discount offer, the downgrade is canceled. The client remains on the current plan and the discount begins according to the configured billing-cycle behavior.

4

SaaS V1 Subscription Sync at the Effective Date

Eligible SaaS V1 subscriptions sold through a selling sub-account can have both a Stripe subscription and a corresponding subscription record in that selling sub-account. Because a configured downgrade is future-effective, the subscription bridge should be understood in relation to the date the lower plan actually becomes active.

StageWhat Happens
Downgrade scheduledThe current plan remains active. The client keeps current-plan features until the effective date.
Discount acceptedThe downgrade is canceled, so the lower plan does not become effective.
Keep My Plan selectedThe scheduled downgrade is canceled before it becomes effective.
Downgrade becomes effectiveFor an eligible V1 selling-sub-account subscription, the supported plan-change flow updates Stripe and the corresponding selling-sub-account subscription.

After an eligible V1 downgrade becomes effective: The current product and price can remain aligned between the supported subscription records, downstream invoices can reflect the new plan information, and applicable tax can be recalculated using current plan data when tax is already configured.

Not retroactive: Historical mismatches between Stripe and an existing selling-sub-account subscription are not automatically backfilled. A future qualifying plan change can update both records through the supported synchronization flow.

Manual Stripe edits: Do not assume arbitrary subscription changes made directly in Stripe trigger the selling-sub-account synchronization. The bridge is documented for supported SaaS upgrade and downgrade events.

5

How To Set Up the Downgrade Flow

Configure the downgrade flow before enabling it for clients so the available reasons, retention offer, and timing match your agency's billing and retention strategy. The global setting controls whether eligible sub-account admins can access the self-service downgrade experience.

Step 1: Enable Downgrades

Enabling the downgrade option makes the self-service downgrade action available to eligible client administrators. Keep the setting off if your agency wants all downgrade requests handled manually.

  1. From Agency View, go to SaaS Configurator > Downgrade Settings.
  2. Turn Allow clients (account admins) to downgrade their subscription ON or OFF.

Note: When the setting is disabled, clients do not see the self-service downgrade option in their billing settings.

Downgrade Settings showing the self-service downgrade toggle

Step 2: Manage Downgrade Reasons

Downgrade reasons capture structured feedback at the moment a client considers moving to a lower plan. Use reasons that help your team identify actionable pricing, adoption, or product trends.

  • Start with the provided default reasons, such as pricing or feature-usage concerns.
  • Edit existing reasons to match your business.
  • Remove reasons that are not relevant.
  • Add new reasons up to the supported character limit.

Tip: Keep downgrade reasons concise and distinct so Activity Logs can reveal meaningful churn patterns instead of collecting overlapping answers.

Downgrade Settings showing configurable downgrade reasons

Step 3: Configure Discount Offers

A retention discount can give an eligible V1 client a reason to remain on the current plan before the downgrade is scheduled. If the client accepts the offer, the downgrade is canceled and the client stays on the existing plan.

  1. Turn Enable Discount Offer ON.
  2. Enter the discount percentage.
  3. For monthly plans, configure the discount duration.
  4. Choose whether an eligible client can receive the offer more than once.
  5. Click Save.

V1 only: Discount deflections are currently available for supported SaaS V1 flows and are not currently supported for V2 downgrade flows.

Downgrade Settings showing the optional retention discount configuration
6

Customer Downgrade Flow

The customer flow separates the decision to downgrade from the date the new plan becomes active. Clients first choose a reason and, when eligible, see the configured retention offer before the downgrade is scheduled for the next billing cycle.

  1. Go to Account Settings > Billing > Modify Subscription > Downgrade.
    Client Billing page showing the option to modify or downgrade a SaaS subscription
  2. Select a downgrade reasonfrom the agency's configured list.
    Client downgrade flow showing the downgrade reason selection
  3. If an eligible V1 retention offer is enabled, review the discount. If the client accepts it, the downgrade is canceled and the client remains on the current plan.
    Client downgrade flow showing the optional retention discount offer
  4. If the client declines or skips the available deflection, the downgrade is scheduled for the start of the next billing cycle.
    Confirmation showing the scheduled SaaS downgrade and effective billing date

Before the effective date: The client remains on the current plan. If they select Keep My Plan, the scheduled downgrade is canceled and the lower plan never becomes effective.

7

Track Activity Using Downgrade Logs

Activity Logs help agencies identify why clients consider downgrading, which offers successfully retain clients, and which plan changes proceed. Exportable records also provide a useful audit trail for support and retention analysis.

  1. Go to SaaS Configurator > Cancellation Settings and scroll to Activity Logs.
  2. Review available information such as the sub-account, timestamp, outcome, downgrade reason, plan change, next billing date, and initiating user.
  3. Use Download to export the available activity data for reporting or deeper analysis.
SaaS Configurator Activity Logs showing downgrade and deflection activity
8

Frequently Asked Questions

Q: Does scheduling a downgrade immediately change the client's V1 subscription?
No. The current plan remains active until the scheduled effective date. For an eligible V1 selling-sub-account subscription, the supported synchronization occurs when the qualifying downgrade becomes effective.
Q: What happens if the client accepts the discount?
The downgrade is canceled and the client remains on the current plan. The configured discount applies according to the applicable billing-cycle behavior.
Q: Can clients reverse a scheduled downgrade?
Yes. Before the effective date, the client can use Keep My Plan from the subscription-management flow to cancel the scheduled downgrade.
Q: Why doesn't a V2 client see the discount offer?
The downgrade discount deflection is currently supported for eligible V1 flows and is not currently available for V2 downgrade flows.
Q: Are existing V1 Stripe and selling-sub-account subscription mismatches automatically fixed?
No. Existing mismatches are not automatically backfilled. A future qualifying plan change can update both records through the supported synchronization flow.
Q: Does changing the subscription directly in Stripe guarantee the selling-sub-account record will sync?
No. Do not assume arbitrary manual Stripe edits trigger the bridge. The synchronization is documented for supported SaaS upgrade and downgrade events.

Need Help?

If a scheduled downgrade or retention offer is not behaving as expected, first identify whether the client is using SaaS V1 or SaaS V2 and confirm the downgrade has actually reached its effective date.

  • If the downgrade was only scheduled: The current plan and features should remain active until the next billing cycle.
  • If the client accepted a discount: The downgrade should be canceled and the client should remain on the current plan.
  • If Keep My Plan was selected: The scheduled downgrade should no longer become effective.
  • For eligible SaaS V1 subscriptions: After the downgrade becomes effective, verify both Stripe and the corresponding selling-sub-account subscription reflect the current plan.
  • For older V1 mismatches: Historical differences are not automatically backfilled.
  • For manual Stripe changes: Do not assume a direct edit automatically triggers the selling-sub-account synchronization.
  • For SaaS V2: Discount deflections are not currently available in the downgrade flow.