Membership phase history
Membership phase history is the ordered record of every tier transition a membership has gone through β including upgrades, downgrades, and cancellations of pending transitions. Reviewing this history helps you understand how a membership reached its current state and verify that scheduled changes were applied or cancelled correctly.
Audience: Center managers and administrators who need to audit membership lifecycle changes.
On this page
- Before you begin
- How phase history works
- View membership phase history
- Understand phase states
- Cancel a pending upgrade or downgrade
- Tips
- Troubleshooting
- Related articles
Before you begin
The guest must have an active or previously active membership on their profile.
Phase history is generated automatically when a membership is first sold and updated whenever a tier transition occurs. No manual setup is required.
To view a guest's membership details, navigate to the guest's profile page and select the Memberships tab.
To cancel a pending upgrade or downgrade, you need the following permissions:
Permission: Upgrade (under Memberships) β Required to cancel a pending upgrade. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Upgrade
Permission: Downgrade (under Memberships) β Required to cancel a pending downgrade. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Downgrade
How phase history works
When a membership is first sold, Zenoti creates the initial phase record β Phase 1 β with a state of Current. This record captures a snapshot of the membership at the time of sale, including the membership status, recurring collection amounts, credit balances, billing dates, and any add-on member actions.
Each time a tier transition occurs β an upgrade, a downgrade, or the cancellation of a scheduled transition β Zenoti appends a new phase record to the sequence. Phases are numbered in the order they were created and are always displayed in ascending order, so you can trace the full lifecycle of the membership from sale to its current state.
Each phase record captures the following information at the moment the transition occurred:
- Membership status
- Recurring collection amounts
- Credit balances
- Billing dates
- Add-on member actions β both retained and removed members
Note: Phase history is read-only. You cannot edit or delete individual phase records.
What triggers a new phase
A new phase record is created when:
- A membership is first sold (Phase 1, state: Current)
- A scheduled in-place upgrade takes effect
- A scheduled in-place downgrade takes effect
- A pending upgrade or downgrade is cancelled (the scheduled phase is marked Cancelled)
How cancelling a pending transition works
When you cancel a scheduled upgrade or downgrade before it takes effect, Zenoti marks the scheduled phase record as Cancelled and sets it to inactive. The current live phase β the one with state Current β is not modified. The membership continues under its existing terms as if the transition had never been scheduled.
Important: Cancelling a pending upgrade or downgrade does not affect the guest's current membership benefits, billing schedule, or credit balances.
View membership phase history
- Navigate to the guest's profile page.
- Select the Memberships tab.
- Locate the membership you want to review and select its name to open the membership details.
- Review the phase history displayed on the membership details page. Phases are listed in ascending order by phase number, with the earliest phase at the top.
Each row in the phase history shows the phase number, the state of that phase, and a snapshot of the membership at the time the phase was recorded.
Worked example: A guest purchased a Gold membership in January (Phase 1, Current). In March, an upgrade to Platinum was scheduled. In April, the upgrade was cancelled before it took effect. The phase history shows:
Phase State Description 1 Current Original Gold membership, sold January 2 Cancelled Scheduled Platinum upgrade, cancelled April The guest remains on the Gold membership. Phase 1 is unchanged.
Understand phase states
Each phase record carries one of the following states.
The table below describes each state and what it means for the membership.
| State | Meaning |
|---|---|
| Current | The active live phase. This is the phase that governs the membership's current terms, billing, and benefits. Only one phase can be Current at a time. |
| Cancelled | A scheduled upgrade or downgrade that was cancelled before it took effect. The membership continues under the previous Current phase. |
Note: When a transition takes effect β for example, when a scheduled upgrade activates β the previous Current phase transitions out and the new phase becomes Current. The phase history retains all prior phases for audit purposes.
Cancel a pending upgrade or downgrade
If a scheduled upgrade or downgrade has not yet taken effect, you can cancel it from the guest's membership details page.
Important: Review the guest's upcoming billing dates and benefit expectations before cancelling a pending transition. Once cancelled, the scheduled transition cannot be reinstated β you would need to schedule a new upgrade or downgrade.
- Navigate to the guest's profile page.
- Select the Memberships tab.
- Locate the membership with the pending transition and select its name to open the membership details.
- To cancel a pending upgrade, select Cancel Upgrade. To cancel a pending downgrade, select Cancel Downgrade.
- In the confirmation dialog titled Cancel Upgrade / Downgrade, confirm the cancellation.
Zenoti marks the scheduled phase as Cancelled and the membership continues under its current terms. A new phase record reflecting the cancellation is added to the phase history.
Note: Cancelling a pending transition does not affect the current live phase. The membership status, billing schedule, credit balances, and add-on member configuration remain unchanged.
Tips
- Use phase history to resolve billing disputes. If a guest questions why their collection amount changed, the phase history shows exactly when a transition occurred and what the billing amounts were before and after.
- Check phase history before scheduling a new transition. Reviewing the existing phase sequence helps you confirm whether a previous upgrade or downgrade was completed or cancelled, so you avoid scheduling a redundant transition.
- Phase 1 is always the original sale record. If you need to verify the terms under which a membership was originally sold β including the initial credit balance, billing date, and add-on members β Phase 1 is the authoritative record.
- Cancelled phases remain visible. A cancelled phase is not deleted. It stays in the history so you have a complete audit trail of all scheduled and cancelled transitions.
Troubleshooting
The phase history shows only one phase, but the membership has been upgraded.
If the membership was upgraded using a full cancellation and re-sale rather than an in-place upgrade, the original membership and the new membership are separate records on the guest's profile. Each has its own phase history starting at Phase 1. Navigate to the Memberships tab on the guest's profile and check whether there are two separate membership records.
A pending upgrade or downgrade does not appear in the phase history.
Phase records for scheduled transitions are created when the transition is scheduled, not when it takes effect. If you scheduled an upgrade or downgrade and do not see a corresponding phase record, verify that the transition was saved successfully. Navigate to the membership details page and check whether the upgrade or downgrade is still listed as pending.
The Cancel Upgrade or Cancel Downgrade option is not available.
This option appears only when there is a pending scheduled transition that has not yet taken effect. If the transition has already activated, the phase state will be Current rather than a pending state, and there is nothing to cancel. If you believe a transition should still be pending, check the membership's billing dates to confirm whether the transition date has passed.