ZenotiHelp

Upgrade or downgrade a membership

ZTZenoti Docs Team Updated October 27, 2026 16 min readGuide

Upgrading moves a guest to a higher-tier membership with more benefits or higher pricing. Downgrading moves a guest to a lower-tier membership. Both actions are taken from the guest's membership detail page; the available targets are configured in advance on each membership in master data (under Advanced Properties).

Audience: Front desk staff and administrators who manage guest memberships.


On this page


Before you begin

Permission: Upgrade (under Memberships) β€” required to upgrade memberships. Downgrade β€” required to downgrade memberships. Prorate for upgrade/downgrade β€” required to apply proration during the change. Cancel (under Memberships) β€” required to cancel a pending upgrade or downgrade.

  • Upgrade and downgrade targets must be configured on the source membership in master data (Master data > Memberships > [the membership] > Advanced Properties). If no upgrade targets are configured for the source membership, Upgrade does not appear on the guest's membership detail page; the same applies to downgrade targets and Downgrade.
  • The membership must be in Active status, and its recurring payment status must also be Active. The actions are hidden otherwise (for example, while the membership is frozen, or already has a pending upgrade or downgrade).
  • To change the organization-level settings described in Upgrade and downgrade rules, you need the appropriate permission to access and modify organization settings. Contact your organization owner or administrator if you do not see the Configuration area.

Upgrade a membership

Note: For conceptual background on how upgrade and downgrade targets are configured, see Create a membership.

  1. Open the guest's profile.
  2. In the Active Memberships list, click the membership name to open the membership detail page.
  3. On the membership detail page, click Upgrade. The upgrade dialog opens.
  4. Select the target membership from the upgrade-targets dropdown. The dropdown lists only the upgrade targets configured on the source membership.
  5. Set the Effective date. Today's date applies the change immediately; a future date creates a pending upgrade that takes effect on that date.
  6. (Optional) If the Prorate for upgrade/downgrade option is shown and you hold the permission, turn on proration to charge the guest the prorated difference for the remainder of the current billing cycle.
  7. Choose how to handle the Annual Fee: keep the previous membership's annual fee, charge a custom discounted amount, or charge the new membership's listed annual fee.
  8. (Optional) If the source membership has a Setup Fee rule, choose whether to collect the setup fee on this change. The dialog shows the setup fee details configured for the membership so you can confirm the amount before you commit.
  9. Select the Payment account for recurring billing on the new membership. Add a backup payment method if your organization requires one.
  10. Choose whether to Carry forward the previous membership's lock-in duration and whether to Carry forward the previous membership's start date using the radio options. Selecting previous preserves the existing lock-in cycle and anniversary date; selecting new resets them based on the upgrade target.
  11. Click Upgrade Membership to commit.

Worked example: A guest on a Silver membership (monthly, $50) is being upgraded to Gold (monthly, $80) effective today. Proration is enabled. The guest is 10 days into a 30-day billing cycle, so the system charges a prorated difference of approximately $20 for the remaining 20 days. The admin selects the Gold membership from the dropdown, leaves the effective date as today, enables proration, keeps the previous annual fee setting, and clicks Upgrade Membership. The guest immediately receives Gold benefits and the next full collection of $80 is scheduled on the original billing date.

After upgrading:

  • For an immediate change, the guest moves to the new membership; benefits, pricing, and recurring billing are adjusted on the new schedule.
  • For a future-dated change, the upgrade is marked Pending on the membership detail page until the effective date.
  • The previous membership's membership status changes to Upgrade. See Membership status after an upgrade or downgrade.
  • If the membership has an upgrade notification configured (Membership Upgrade Confirmation), the system sends it.

Downgrade a membership

  1. Open the guest's profile.
  2. In the Active Memberships list, click the membership name to open the membership detail page.
  3. On the membership detail page, click Downgrade. The downgrade dialog opens.
  4. Select the target membership from the downgrade-targets dropdown. The dropdown lists only the downgrade targets configured on the source membership.
  5. Set the Effective date. Today's date applies the change immediately; a future date creates a pending downgrade that takes effect on that date.
  6. (Optional) If the Prorate for upgrade/downgrade option is shown and you hold the permission, turn on proration. On a downgrade, proration credits the guest for the unused portion of the higher-tier billing cycle.
  7. Choose how to handle the Annual Fee, the optional Setup Fee, Payment account, and the Carry forward lock-in duration / start date radios using the same options described under Upgrade a membership.
  8. Click Downgrade Membership to commit.

After downgrading:

  • For an immediate change, the guest moves to the lower-tier membership with the lower-tier benefits and billing.
  • For a future-dated change, the downgrade is marked Pending until the effective date.
  • The previous membership's membership status changes to Downgrade. See Membership status after an upgrade or downgrade.
  • If the membership has a downgrade notification configured (Membership Downgrade Confirmation), the system sends it.

Proration

When the Prorate for upgrade/downgrade permission is granted and proration is enabled in the dialog, the system calculates the prorated amount based on the remaining time in the current billing cycle. On an upgrade this charges the guest the prorated difference; on a downgrade this credits the unused portion of the higher tier. Proration applies whether the change is immediate or future-dated; the resulting invoice is created when the change takes effect.

Membership status after an upgrade or downgrade

A membership carries three independent statuses, and each is backed by its own list of values. Read each one separately: the same word can appear in more than one list and mean something different in each. Membership status drives redemption, recurring status drives collection, and invoice status applies to a single recurring invoice.

When an upgrade or downgrade takes effect, the previous membership's membership status reads Upgrade or Downgrade, and its recurring status moves to the matching value so that collections stop. What happens to that previous membership next depends on the organization setting described in What happens to the previous membership after an upgrade or downgrade.

Membership status

Membership status determines whether the guest can redeem benefits from the membership.

Status What it means
Default No membership status has been set.
Active The membership is live and its benefits can be redeemed.
Inactive The membership is not live, so its benefits cannot be redeemed.
Frozen The membership is frozen. Whether benefits can still be redeemed depends on the freeze type that was selected.
Cancelled The membership has been cancelled.
Expired The membership has passed its expiration date.
Closed An administrator closed the membership.
Not Started The membership record exists but has not been activated yet.
Suspended Repeated collection failures have suspended the membership. Benefit redemption may still be permitted, depending on your organization's redemption settings.
Refunded The membership sale was refunded.
Deleted The membership record was deleted.
Failed A payment failure has left the membership itself in a failed state.
Upgrade The guest moved off this membership through an upgrade.
Downgrade The guest moved off this membership through a downgrade.
Pending The membership is waiting on confirmation or payment before it becomes active.
Transferred The membership was transferred to another center.
Removed The membership was removed from the guest's profile.

Recurring status

Recurring status determines whether the recurring collection schedule runs.

Status What it means
Default No recurring status has been set.
Active Recurring collections are scheduled and run as configured.
Inactive The recurring schedule is not running for this membership.
Frozen Collections are paused for the freeze period.
Cancelled The recurring schedule has been cancelled. On a mid-cycle cancellation, this is the value that changes first.
Expired The recurring schedule has reached the end of its term.
Closed An administrator closed the recurring schedule.
Not Started The recurring schedule has not begun yet.
Suspended Dunning suspended the collection schedule after repeated failures.
Do Nothing Dunning is configured to leave the collection status unchanged after a failure.
Deleted The recurring schedule record was deleted.
Suspended Pending Tries The schedule is suspended, and further collection attempts are still scheduled.
Failed The most recent collection attempt on the schedule failed.
Upgrade The recurring schedule ended because the guest upgraded to another membership.
Downgrade The recurring schedule ended because the guest downgraded to another membership.
Pending Direct Debit A direct debit collection has been sent and has not settled yet.
Transferred The recurring schedule moved with the membership to another center.

Invoice status

Invoice status applies to each individual recurring invoice, not to the membership as a whole.

Status What it means
Default No invoice status has been set.
Pending The invoice is due and has not been collected yet.
Collected The invoice has been paid. Only collected invoices are eligible for refund.
Waived The invoice was waived, so no amount is due.
Stopped Collection on this invoice was stopped.
Cancelled The invoice was cancelled.
Failed The collection attempt on this invoice failed.
Deleted The invoice record was deleted.
Refunded The amount collected on this invoice was refunded.
Pending Direct Debit The invoice was sent for direct debit and has not settled yet.
Batched The invoice has been added to a collection batch.

What the previous membership can and cannot do

In the standard flow, an upgrade or downgrade creates a new membership, and the membership the guest moved off stays on the guest's profile in Upgrade or Downgrade status. (The in-place flow, in which the existing membership moves to the new tier instead, is turned on by Zenoti Support.) That previous membership is not inert β€” the rules below describe exactly what it still does.

Benefits that stay redeemable

Benefits already credited to a membership in Upgrade or Downgrade status stay redeemable until that membership reaches its end date or is expired. This covers:

  • Service credits
  • Class credits
  • Credit amount
  • Guest passes

A membership with no end date stays redeemable until it is expired.

Its discounts and member pricing also keep applying, unless your organization has turned on Stop discounts and member pricing from upgraded or downgraded memberships.

To close these benefits out, use the What happens to the previous membership after an upgrade or downgrade setting and choose either Expire the previous membership immediately or Expire previous memberships when the new membership is cancelled or terminated. See Membership upgrade and downgrade handling settings.

Actions that are not available

The guest profile does not offer Freeze, Waive, or Cancel for a membership in Upgrade or Downgrade status. Such a membership cannot be frozen, waived, or cancelled, and its benefits end only when it reaches its end date or is expired.

Auto-renewal cannot be configured for a membership in Upgrade or Downgrade status β€” the system rejects renewal setup for that status.

Actions that remain available

  • Adding guests. The Upgrade or Downgrade status does not by itself prevent adding guests (add-on members) to the membership.
  • Transferring service credits. Service credits on a membership in Upgrade or Downgrade status remain transferable, and a transfer undoable, under the normal credit-transfer rules. See Manage membership credits and benefits.

Post-expiry redemption settings do not apply yet

The Redemption post expiry or cancellation setting on the membership (Allow, Allow with authorization, or Block) is not evaluated for a membership in Upgrade or Downgrade status that has not reached its end date. Such a membership redeems through the normal path, so a Block value shown on it does not stop its credits from being used.

Cancel a pending upgrade or downgrade

If a future-dated upgrade or downgrade has been scheduled but has not yet taken effect, you can cancel it from the same page where it was initiated. Once the change has taken effect, it can no longer be cancelled β€” at that point the guest is on the new membership and any further change is a new upgrade or downgrade.

  1. Open the guest's profile.
  2. In the Active Memberships list, click the name of the membership that has the pending change.
  3. On the membership detail page, click Cancel Upgrade (when the pending change is an upgrade) or Cancel Downgrade (when the pending change is a downgrade). The button appears only while a pending change exists on the membership.
  4. In the Cancel Upgrade / Downgrade confirmation dialog, click Yes. The pending change is removed and the membership remains on its current tier.

Upgrade and downgrade rules

The rules that govern upgrades and downgrades across your organization are managed on a dedicated page at Configuration > Memberships > Membership actions > Upgrade and downgrade rules.

Note: The page opens with an informational banner titled New: upgrade or downgrade without creating a new membership. The banner describes the in-place upgrade and downgrade capability, in which the guest's existing membership moves to the new tier instead of a new membership being created, and it notes that the settings on this page apply only to the legacy flow, where each upgrade or downgrade creates a new membership. Select Learn more in the banner to read the details.

To review or change these rules:

  1. Go to Configuration > Memberships > Membership actions > Upgrade and downgrade rules.

  2. Set the default date that staff see in the action windows:

    • Choose the default upgrade date to be selected in the upgrade action window in guest profile β€” select Current date or Next billing date.
    • Choose the default downgrade date to be selected in the downgrade action window in guest profile β€” select Current date or Next billing date.

    Staff can still change the date in the dialog before committing the change.

  3. Set the Stop discounts and member pricing from upgraded or downgraded memberships toggle. See Stop discounts and member pricing from upgraded or downgraded memberships.

  4. Select one of the three options under What happens to the previous membership after an upgrade or downgrade. See What happens to the previous membership after an upgrade or downgrade.

  5. Click Save.

Stop discounts and member pricing from upgraded or downgraded memberships

Turn on Stop discounts and member pricing from upgraded or downgraded memberships to stop the previous membership from continuing to give the guest a benefit after they have moved to a different tier.

When the toggle is enabled, discounts and member pricing from a membership in Upgraded or Downgraded status are no longer applied at the Point of Sale, in the guest portal, or in online booking. Services, visits, and guest passes that were already credited to that membership can still be redeemed.

When the toggle is disabled, the previous membership's discounts and member pricing continue to apply.

What happens to the previous membership after an upgrade or downgrade

What happens to the previous membership after an upgrade or downgrade controls how memberships that a guest has moved off are handled. Select one of the following options:

  • Keep the previous membership in Upgraded or Downgraded status (default) β€” the previous membership stays on the guest's profile in its post-change status and is not expired by the system.
  • Expire the previous membership immediately β€” the previous membership expires as soon as the upgrade or downgrade takes effect.
  • Expire previous memberships when the new membership is cancelled or terminated β€” the previous membership expires only when the membership the guest moved to is cancelled or reaches its termination date.

Important: This setting applies to future upgrades and downgrades only. Memberships that were already left behind by an earlier upgrade or downgrade are not changed when you save the setting.

Webstore upgrades and downgrades

Guests can initiate upgrades and downgrades themselves from the Webstore. The Webstore can be configured with a different list of upgrade and downgrade targets than the admin interface or the CMA. These per-channel target lists are set on the source membership under Advanced Properties (see Create a membership).

Important: Upgrade and downgrade actions do not migrate existing members to a new version of the same membership. The lock-in duration and start date radios in the dialog control whether the previous membership's lock-in cycle and anniversary date carry forward to the new membership or are reset.


Tips

  • Configure targets before the guest arrives. Upgrade and downgrade target lists are statically configured per membership in Master data > Memberships > [the membership] > Advanced Properties. If a target is not configured, it will not appear in the dialog. Set up targets in advance so front desk staff are not blocked at the point of action.
  • Use future-dated changes for billing-cycle alignment. Setting the effective date to the guest's next billing date avoids mid-cycle proration complexity and ensures the guest's first collection on the new membership aligns with their existing billing schedule. Setting Next billing date as the default on the Upgrade and downgrade rules page makes this the starting point for every change.
  • Decide how previous memberships are handled before you start moving guests. The What happens to the previous membership after an upgrade or downgrade setting applies only to changes made after you save it, so choosing the option that matches your reporting and liability practice early avoids a mixed set of records later.
  • Verify the lock-in carry-forward choice before confirming. If the source membership has a lock-in period remaining, selecting new resets the lock-in clock on the target membership. Selecting previous preserves the remaining lock-in duration. Confirm with the guest which outcome they expect before clicking Upgrade Membership or Downgrade Membership.

Troubleshooting

  • The Upgrade or Downgrade button does not appear on the membership detail page. The most common cause is that no upgrade or downgrade targets have been configured on the source membership in master data. Navigate to Master data > Memberships, open the source membership, go to Advanced Properties, and verify that the Membership Upgrade options or Membership Downgrade options dropdown contains at least one target. If the membership is not in Active status (for example, it is frozen or has a pending change already), the buttons are also hidden until the membership returns to Active.
  • The proration option is not visible in the dialog. Proration during upgrade or downgrade requires the Prorate for upgrade/downgrade permission. Confirm with your administrator that this permission is enabled for your security role. If the permission is granted and the option is still not visible, verify that the organization's billing configuration supports proration.
  • The guest still receives a discount or member price from the membership they moved off. Go to Configuration > Memberships > Membership actions > Upgrade and downgrade rules and turn on Stop discounts and member pricing from upgraded or downgraded memberships, then click Save. Services, visits, and guest passes that were already credited to the previous membership remain redeemable even after the toggle is enabled β€” that is expected behavior and is not controlled by this setting.
  • The guest is still redeeming credits from the membership they moved off, and its Redemption post expiry or cancellation value is set to Block. This is expected. A membership in Upgrade or Downgrade status that has not reached its end date redeems through the normal path, so the post-expiry redemption value on it is not evaluated. To stop the credits from being used, expire the previous membership β€” either set What happens to the previous membership after an upgrade or downgrade to Expire the previous membership immediately before future changes, or expire the existing membership directly.
  • Freeze, Waive, and Cancel are missing on the previous membership. These actions are not offered for a membership in Upgrade or Downgrade status. Its benefits end when it reaches its end date or is expired, so use the What happens to the previous membership after an upgrade or downgrade setting rather than looking for a cancel action on the membership itself.
  • Auto-renewal cannot be set up on the previous membership. Auto-renewal is not configurable for a membership in Upgrade or Downgrade status, and the system rejects the renewal setup. Configure renewal on the membership the guest has moved to instead. See Membership renewal.
  • A pending upgrade or downgrade cannot be cancelled. The Cancel Upgrade and Cancel Downgrade buttons appear only while the change is still pending (that is, the effective date has not yet passed). If the effective date has already passed and the change has taken effect, the guest is now on the new membership. To revert, initiate a new downgrade or upgrade in the opposite direction.

Was this article helpful?
Your feedback helps us improve our documentation.