This document explains every setting available in the WordPress admin, including their purpose, impact, and recommended configurations for different business models.
Accessing Plugin Settings
Navigate to your WordPress admin and access the plugin settings:
WordPress Admin → Settings → Better Sub Switcher
The settings are organized into two main tabs:
- General Tab – Core functionality and customization options
- License Tab – License key management and activation
General Settings Tab
Enable Subscription Switcher
Master switch that enables or disables the entire subscription switching functionality.
Skip Cart Page
When enabled, customers bypass the cart page and go directly to checkout after selecting a new subscription plan.
Default: Enabled (Yes)
Enable Product Details Screen
Shows “Learn More” links that open detailed product information screens with images, descriptions, reviews, and variation selectors.
Default: Enabled (Yes)
Enable Quantity Controls
Adds +/- buttons and quantity input fields for products that support quantity adjustments.
Default: Disabled (No)
Layout
Controls how subscription plans are displayed in the modal interface.
Layout Options:
List View (Default):
- Plans displayed vertically in a list
- Each plan takes full width
- Better for detailed information
- Ideal for mobile devices
- Supports longer descriptions
Horizontal View:
- Plans displayed side-by-side
- Compact card format
- Better for plan comparison
- Ideal for desktop viewing
- Space-efficient for multiple plans
Text Customization Settings
Modal Title
Main heading at the top of the subscription switching modal.
Default: “Modify Your Subscription”
Pricing Summary Text
Header for the pricing breakdown section showing costs and billing details.
Default: “Pricing Summary”
Button Text (Select)
Primary action button for choosing a subscription plan.
Default: “Select this plan”
Selected Button Text
Button state when a plan has been chosen but not yet confirmed.
Default: “Selected”
Learn More Text
Link text that opens detailed product information screen. Only appears when “Enable Product Details Screen” is enabled.
Default: “Learn More”
Select Options Text
Button text for products with variations (size, color, etc.) that require option selection. Only appears for variable products with multiple options.
Default: “Select Options”
Cancel Button Text
Button to close the modal without making changes.
Default: “Cancel”
Back to Plans Text
Navigation button to return from product details to plan selection.
Default: “Back to Plans”
Continue to Checkout Text
Primary action button when “Skip Cart” is enabled.
Default: “Continue to Checkout”
Current Plan Text
Badge or label on the customer’s existing subscription plan.
Default: “Current Plan”
Loading Text
Message shown while subscription data is being loaded via AJAX.
Default: “Loading subscription options…”
Renewal Payment Text
Information about when the next payment will be charged. The ‘%s’ placeholder is automatically replaced with the formatted renewal date.
Default: “Renewal payment due on %s”
Today’s Payment Text
Label for immediate charges in the pricing summary. This appears in pricing calculations and should be clear about immediate charges.
Default: “Today’s Payment:”
Renewal Text (Simple Products)
Renewal information for simple subscription products.
Default: “Renews at %s”
Multiple Renewal Options Text
Information for variable products with multiple subscription options. Only appears for variable products with multiple subscription terms.
Default: “Multiple renewal options starting at %s”
Recommended Badge Text
Badge text on plans marked as recommended in WooCommerce. This text can be overwritten from the single product settings.
Default: “Recommended”
Product-Level Settings
You can also override the following settings for specific products within the edit product screen:
Location:
- WooCommerce → Products → Edit Product → Advanced Tab
- For variations: WooCommerce → Products → Edit Product → Variations
Appears as: “Better Sub Switcher Settings” section in the product data panel
Available Product Settings
Custom Renewal Text
Override the global renewal text for this specific product
Mark as Recommended
Display a “Recommended” badge on this product in the switching modal
Custom Recommended Text
Override the global recommended badge text for this specific product