Membership Cycle Switcher
Purpose and when to use
The Membership Cycle Switcher lets visitors switch between billing cycles (e.g. monthly vs annual) on the frontend. It works with Membership Item modules: when the user changes the cycle, the membership items update to show the selected cycle’s price and details. Use it on pricing pages where you offer the same plans at different billing intervals.
Not the same as upgrade/downgrade
This module is for choosing a billing cycle (e.g. Monthly vs Annual) on a pricing or signup page — before the visitor has subscribed. Upgrade/downgrade (changing to a different membership plan) is done by existing members from their account page via the plan switcher. Do not confuse the Cycle Switcher with account-level plan changes.
- Default state — Set which billing cycle is selected when the page loads.
- Active/inactive text — Optional; style or label the selected vs unselected option.
- Design options — Switcher style (Select dropdown or Toggle), select style, and title (with HTML tag for SEO).
Compatibility and performance notes
- Divi: Current Divi version with Divi Membership 2.0.x or later.
- Membership Item: Billing cycles in the switcher must match those configured in the Membership Item modules on the same page; cycle names must be identical.
Add to page
- In the Divi Builder, add a new module and choose Membership Cycle Switcher (under Divi Membership).
- Set Title and Title HTML Tag (e.g. H2) for accessibility and SEO.
- Under Billing Cycles, select the cycles to offer (e.g. Monthly, Annual); these must match the cycles used in your Membership Item modules.
- Set Default Billing Cycle to the option shown when the page loads.
- Choose Switcher Style: Select (dropdown) or Toggle (two options); if Select, set Select Style.
- Save and test: change the switcher and confirm Membership Item content updates.
Settings
| Setting | Type | Default | Depends On | Notes |
|---|---|---|---|---|
| Title | text | — | — | Title above the switcher (e.g. "Choose Your Plan"). |
| Title HTML Tag | select | h1–h6 | — | Semantic heading level. |
| Billing Cycles | multi-select | — | — | Cycles to show; must match Membership Item modules. |
| Default Billing Cycle | select | — | Billing Cycles | Which cycle is selected on load. |
| Switcher Style | select | Select / Toggle | — | Dropdown (unlimited options) or two-option toggle. |
| Select Style | select | — | Switcher Style: Select | Dropdown appearance. |
Examples and common patterns
- Monthly vs Annual: Use two billing cycles and Toggle style for a simple "Monthly | Annual" switch.
- Multiple cycles: Use Select style to offer three or more cycles (e.g. monthly, 6-month, annual).
Pitfalls and limits
tip
- The billing cycles in the switcher must match those set up in the Membership Item modules on the page.
- Billing cycle names must be identical between the switcher and membership items.
- If the switcher and membership items use different cycle names or sets, prices and details will not update correctly.
Related links
- Membership Item — Displays plan details for the selected cycle.
- Feature Overview — Plans and billing cycles.
What's Next
- Membership Item — Display plan details and register button.
- Register module — Configure the registration form.
- Feature Overview — Plans and pricing.