Upgrading from BuddyX Free to BuddyX Pro

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:
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 > BuddyPress > 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

Plugin Compatibility

BuddyX Pro includes enhanced styling and integration for these plugins:

Activity Share Pro & BuddyPress Reactions

• Full styling support for reaction buttons and counters
• Share modal styling that matches your theme
• Recommended plugins shown in Getting Started > Community Addons tab

rtMedia

• Styled media galleries and lightboxes
• Upload button integration
• Activity stream media display

MediaPress

• Gallery layouts matching theme style
• Media player styling
• Override activity media list view option in BuddyPress General settings

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 thememodsbuddyx 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 > BuddyPress > Single Group
• Member Profiles – Set profile layout at Customize > BuddyPress > Single Member
• WP Login Branding – Style login page at Customize > WP Login

Plugin Integrations (If Applicable)

• Activity Share Pro – Install from Getting Started > Community Addons
• BuddyPress Reactions – Install from Getting Started > Community Addons
• rtMedia – Verify media galleries display correctly
• MediaPress – Check activity media settings at Customize > BuddyPress > General

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:

• Installation Guide – Fresh installation instructions
• Demo Importer – Import pre-built demos
• Quick Start Guide – Get started quickly
• Child Theme – Using child themes

---

Need Help?

• Visit our Documentation Portal
• Contact Support at support@wbcomdesigns.com