BuddyX
Get BuddyX Pro

Upgrading from BuddyX Free to BuddyX Pro

Pro feature

This guide helps you migrate your settings when upgrading from the free BuddyX theme to BuddyX Pro. The built-in migration tool automatically transfers your customizer settings, saving you time and preserving your design choices.

Before You Upgrade

Pre-Upgrade Checklist

  • Backup your WordPress site (database and files)
  • Note any custom CSS you've added to BuddyX free
  • Document any child theme customizations
  • Ensure you have a valid BuddyX Pro license
  • Test the upgrade on a staging site first (recommended)

What Gets Migrated

The migration tool automatically transfers 80+ theme settings from BuddyX free to BuddyX Pro:

Category Settings Migrated
Layout Site layout, container width
Loader Site loader, loader background color
Page Mapping Login page, registration page, 404 page
Typography Site title, tagline, headings (H1-H6), menu, submenu, body text
Colors Primary color, link colors, button colors, background colors
Header Header background, search, cart, login/register links
Subheader Background settings, breadcrumbs, typography
Blog Layout options, image position, grid columns, masonry view
Single Post Content width, title layout, sidebar options
Sidebars Main sidebar, BuddyPress sidebars, bbPress sidebar, WooCommerce sidebar, sticky sidebar
WP Login Custom login settings, logo, background
Footer Background, colors, copyright text, link colors

Special Color Mappings

BuddyX Pro has a more organized color system. During migration, some color settings are automatically mapped to their new locations:

BuddyX Free Setting BuddyX Pro Setting
Site Title Typography → Color Site Title Color
H1 Typography → Color Headings Color
Tagline Typography → Color Body Text Color
Menu Typography → Color Menu Color
Body Typography → Color Body Text Color
Subheader Typography → Color Subheader Title Color

How to Upgrade

Step 1: Install BuddyX Pro

  1. Download BuddyX Pro from your WBCom Designs account
  2. Go to Appearance > Themes > Add New > Upload Theme
  3. Upload the buddyx-pro.zip file
  4. Click Install Now
  5. Do NOT activate yet if you want to preserve your BuddyX free settings

Step 2: Activate BuddyX Pro

  1. After installation, click Activate
  2. You'll be redirected to the Getting Started page
  3. The migration tab will automatically appear if BuddyX free settings are detected

Step 3: Run the Migration

  1. Navigate to Appearance > Getting Started
  2. Click on the BuddyX Free to Pro Upgrade tab
  3. Check the box: Migrate BuddyX free theme options to the BuddyX Pro theme
  4. Click the Upgrade button
  5. Wait for the success message: "Successfully migrate Buddyx Free theme options to Buddyx Pro theme"

Navigate to Appearance > Getting Started to find the migration tab

Step 4: Verify Your Settings

After migration, verify your settings were transferred correctly:

  1. Go to Appearance > Customize
  2. Check the following sections:
    • Site Identity - Logo and site title
    • Skin > Colors - Primary and secondary colors
    • Typography - Font families and sizes
    • Header - Layout and elements
    • Footer - Background and content colors
  3. Visit your frontend to confirm the appearance

What's NOT Migrated

Some items require manual setup after migration:

Manual Configuration Required

Item Action Needed
Custom CSS Copy from BuddyX free Customizer > Additional CSS to BuddyX Pro
Child Theme Files Update child theme to extend buddyx-pro instead of buddyx
Menu Assignments Re-assign menus if new menu locations exist
Widget Areas BuddyX Pro has additional widget areas - configure as needed
Pro-Only Features Configure new features like Dark Mode, Side Panel, etc.

New Features in BuddyX Pro

After migration, explore these exclusive BuddyX Pro features that aren't available in the free version:

Sign-in Popup

A modal login/registration popup that appears when users click login links, providing a seamless authentication experience without leaving the current page.

Location: Appearance > Customize > General > Sign-in Popup

Features:

  • Enable/disable popup login
  • Customize popup appearance
  • Configure redirect after login (current page, profile, activity, custom URL)
  • Works alongside or instead of page-mapped login

Side Panel

A slide-out navigation panel that provides quick access to menu items, user profile, and widgets.

Location: Appearance > Customize > Side Panel

Features:

  • Toggle panel open/closed by default
  • Show on desktop, mobile, or both
  • Customize background colors
  • Add menu and widget areas
  • Show/hide logout button for logged-in users

Group Single Settings

Extended customization options for individual BuddyPress/BuddyBoss group pages.

Location: Appearance > Customize > Community Settings > Single Group

Features:

  • Multiple header layout options (Left, Centered, Container, Stretch views)
  • Navigation styles (Default, Icon + Label, Swipe modes)
  • Show/hide group elements (type, activity, description, organizers, privacy)
  • Customize group cover images

Bundled plugins (new in 5.1.0)

BuddyX Pro 5.1.0 ships an in-house plugin ecosystem under the same license - every plugin is built and supported by Wbcom Designs alongside the theme. See Bundled Plugins for the full reference. Quick summary of what they replace in the legacy 5.0.x bundle:

5.0.x plugin 5.1.0 replacement Notes
BuddyPress Reactions Pro Jetonomy Richer reaction model + per-trust-level moderation. The legacy plugin still works on a 5.1.0 install but is no longer marketed.
Activity Share Pro Built into the theme Share buttons are now a theme-level feature in the Single Post + Activity templates. No separate plugin to install.
(no equivalent) MediaVerse Native video upload + hosting + player - no third-party video service needed.
(no equivalent) WB Gamification Points, ranks, badges, leaderboards.
(no equivalent) WP Career Board Job board + resume management.
(no equivalent) WP Sell Services Community service marketplace on WooCommerce.
(no equivalent) WB Ad Manager Display ad zones, sponsorship slots, ad rotation.
(no equivalent) Listora Directory builder.
(no equivalent) Learnomy First-party LMS - courses, lessons, quizzes, certificates.

Third-party plugins that keep working:

Plugin What stays the same
rtMedia Styled media galleries, upload button, activity stream media
MediaPress Gallery layouts, media player styling, activity media list-view toggle in BuddyPress General settings
GamiPress / myCred Coexist with WB Gamification - track separate points
WP Job Manager Coexists with WP Career Board - install only one job board path
LearnDash / LifterLMS / Tutor / Sensei / LearnPress All continue to integrate; Learnomy is opt-in

Additional Pro Features

Feature Description Location
Dark Mode Light/dark theme toggle for visitors Skin > Color Mode
Advanced Headers 5 header layout styles Site Header
WP Login Branding Modern, Classic, Split login themes WP Login section
Color Presets Pre-designed color schemes Skin > Color Presets
Extended Typography More font customization Typography panel
Member Profile Layouts 6 profile header styles BuddyPress > Single Member
Social Links Add social icons to member profiles BuddyPress > Single Member

Troubleshooting

Migration Tab Not Showing

Problem: The "BuddyX Free to Pro Upgrade" tab doesn't appear.

Cause: BuddyX free theme settings were not found in the database.

Solutions:

  1. Ensure BuddyX free was previously active on this site
  2. Check that theme_mods_buddyx exists in wp_options table
  3. If you never customized BuddyX free, there's nothing to migrate

Settings Not Transferring

Problem: Some settings didn't migrate correctly.

Solutions:

  1. Clear any caching plugins
  2. Try the migration again (if button is disabled, settings already migrated)
  3. Manually configure the missing settings in Customizer

Button Shows "Disabled"

Problem: The Upgrade button is grayed out and disabled.

Cause: Migration has already been completed for this site.

Note: The migration is designed to run only once to prevent accidentally overwriting your BuddyX Pro customizations.

Colors Look Different

Problem: Colors appear slightly different after migration.

Cause: BuddyX Pro has separate color controls that didn't exist in the free version.

Solution:

  1. Go to Appearance > Customize > Skin
  2. Fine-tune individual color settings
  3. Consider using a Color Preset as a starting point

Post-Migration Checklist

After completing the migration, work through this checklist:

Verify Migrated Settings

  • Verify site logo appears correctly
  • Check header layout and menu display
  • Confirm colors match your original design
  • Test typography on headings and body text
  • Review sidebar placements
  • Check footer content and colors
  • Test on mobile devices
  • Verify BuddyPress/BuddyBoss components display correctly
  • Check WooCommerce pages (if applicable)
  • Re-add any custom CSS
  • Update child theme (if using one)

Configure New Pro Features

  • Sign-in Popup - Enable modal login at Customize > General > Sign-in Popup
  • Side Panel - Configure slide-out menu at Customize > Side Panel
  • Dark Mode - Enable light/dark toggle at Customize > Skin > Color Mode
  • Group Settings - Customize group pages at Customize > Community Settings > Single Group
  • Member Profiles - Set profile layout at Customize > Community Settings > Single Member
  • WP Login Branding - Style login page at Customize > WP Login

Plugin Integrations (If Applicable)

  • Bundled plugins - Install the ones you need (Jetonomy, MediaVerse, WB Gamification, WP Career Board, WP Sell Services) from the BuddyX Pro Plugins dashboard notice. See Bundled Plugins.
  • rtMedia - Verify media galleries display correctly.
  • MediaPress - Check activity media settings at Customize > Community Settings > General Setting.
  • Legacy 5.0.x plugins - If Activity Share Pro / BuddyPress Reactions Pro are still active from the free build, you can keep them or replace with Jetonomy (reactions) + the built-in social-share controls (sharing).

Reverting to BuddyX Free

If you need to go back to the free theme:

  1. Your BuddyX free settings are still stored in the database
  2. Simply activate the BuddyX free theme
  3. Your original settings will be restored
  4. BuddyX Pro settings remain separate and won't be lost

Note: Each theme stores its settings independently, so switching between them won't cause data loss.

Getting Help

If you encounter issues during migration:

  1. Documentation: Check our full documentation
  2. Support: Submit a ticket at wbcomdesigns.com/support
  3. Community: Join our Facebook Group

When contacting support, include:

  • WordPress version
  • BuddyX Pro version
  • Screenshots of the issue
  • Any error messages displayed

Related Guides:

Got a question? We're a friendly team - happy to help.