Skip to content
Docs

Troubleshooting

Quick solutions to common BuddyX Pro issues.

Quick Fixes (Try First)

Section titled “Quick Fixes (Try First)”

Before anything else:

  1. Clear browser cache - Ctrl+Shift+R (Windows) / Cmd+Shift+R (Mac)
  2. Clear site cache - Purge caching plugin
  3. Try incognito mode - Rules out browser extensions
  4. Wait 5 minutes - Server may need time

Installation Issues

Section titled “Installation Issues”

Theme won’t activate

Section titled “Theme won’t activate”

Check PHP version:

  1. Tools > Site Health > Info > Server
  2. Need PHP 8.1 or higher
  3. Contact host to upgrade if needed

Check WordPress version: Need WordPress 6.0+. Update at Dashboard > Updates.

Wrong ZIP file: Upload the inner buddyxpro folder, not the download wrapper.

White screen after activation

Section titled “White screen after activation”

Increase memory:

// Add to wp-config.php
define( 'WP_MEMORY_LIMIT', '256M' );

Enable debugging:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Check /wp-content/debug.log for errors.

Customizer Issues

Section titled “Customizer Issues”

Customizer blank or missing options

Section titled “Customizer blank or missing options”

BuddyX Pro 5.1.0 dropped the Kirki dependency - the customizer framework is now built into the theme, so there is nothing extra to install. If the customizer panel renders blank, verify:

  1. The theme is fully unzipped under wp-content/themes/buddyx-pro/ (a partial upload missing inc/Customizer_Framework/ will fail to register fields).
  2. No JS error in the browser console (a plugin conflict on customize-controls.js can blank the sidebar).
  3. The user has the edit_theme_options capability.

If the panel still shows nothing, switch the theme, then back to BuddyX Pro, to re-register controls.

Changes not saving

Section titled “Changes not saving”
  1. Disable security plugins temporarily
  2. Clear all caches
  3. Try different browser

Changes not showing on frontend

Section titled “Changes not showing on frontend”
Cache Type How to Clear
Browser Ctrl+Shift+R
Plugin WP Rocket > Clear Cache
CDN Cloudflare > Purge Everything

Header Issues

Section titled “Header Issues”

Mobile menu won’t open

Section titled “Mobile menu won’t open”
  1. Clear all caches
  2. Disable JS minification in caching plugin
  3. Check browser console (F12) for JavaScript errors

Cart icon missing

Section titled “Cart icon missing”
  1. Verify WooCommerce is active
  2. Customize > Site Header > Header Elements
  3. Toggle Site Cart to On

Logo wrong size

Section titled “Logo wrong size”

Customize > Site Identity > Logo Width

Or add CSS:

.site-logo-wrapper img { max-width: 180px !important; }

Sticky header not working

Section titled “Sticky header not working”
  1. Customize > Site Header > Sticky Header
  2. Toggle Enable Sticky Header to On
  3. Clear cache

BuddyPress Issues

Section titled “BuddyPress Issues”

Members page 404

Section titled “Members page 404”
  1. Settings > Permalinks
  2. Click Save Changes (don’t change anything)

“Requires BP Nouveau” error

Section titled ““Requires BP Nouveau” error”
  1. Settings > BuddyPress > Options
  2. Select BP Nouveau under Template Pack
  3. Save

Activity stream empty

Section titled “Activity stream empty”
  1. Enable Activity at Settings > BuddyPress > Components
  2. Create test content (post status update)
  3. Clear cache

Cover photos won’t upload

Section titled “Cover photos won’t upload”
  1. Check PHP upload limit (need 10MB+)
  2. Check folder permissions: chmod 755 wp-content/uploads

WooCommerce Issues

Section titled “WooCommerce Issues”

Shop page 404

Section titled “Shop page 404”
  1. WooCommerce > Settings > Products
  2. Verify Shop Page is assigned
  3. Settings > Permalinks > Save Changes

Mini-cart not opening

Section titled “Mini-cart not opening”
  1. Clear all caches
  2. Disable JS minification
  3. Check browser console for errors

Performance Issues

Section titled “Performance Issues”

Site loading slowly

Section titled “Site loading slowly”

Quick wins:

  1. Install caching plugin (WP Rocket, W3 Total Cache)
  2. Optimize images (use WebP, compress)
  3. Use CDN (Cloudflare free tier)
  4. Deactivate unused plugins

Customizer slow

Section titled “Customizer slow”
  1. Increase PHP memory to 256MB
  2. Reduce Google Fonts loaded
  3. Disable admin-heavy plugins temporarily

Memory exhausted errors

Section titled “Memory exhausted errors”
// Add to wp-config.php
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

Dark Mode Issues

Section titled “Dark Mode Issues”

Toggle not appearing

Section titled “Toggle not appearing”
  1. Customize > Site Skin > Color Mode
  2. Toggle Dark Mode Toggle to On
  3. Clear cache

Dark mode colors wrong

Section titled “Dark mode colors wrong”

Customize > Site Skin > Dark Mode Colors

Configure:

  • Dark background color
  • Dark text color
  • Dark link color

Mobile Issues

Section titled “Mobile Issues”

Elements overlapping

Section titled “Elements overlapping”
  1. Check custom CSS isn’t breaking mobile
  2. Add mobile-specific CSS:
@media (max-width: 767px) {
    /* Your fixes */
}

Text too small

Section titled “Text too small”

Customize > Typography > Body Typography

Increase font size, or add CSS:

@media (max-width: 767px) {
    body { font-size: 16px; }
}

Error Messages

Section titled “Error Messages”

500 Internal Server Error

Section titled “500 Internal Server Error”
  1. Rename .htaccess to .htaccess-old (test if site loads)
  2. Increase PHP memory/timeout
  3. Check file permissions (files: 644, folders: 755)

Database connection error

Section titled “Database connection error”
  1. Verify credentials in wp-config.php
  2. Contact host - database server may be down

White screen of death

Section titled “White screen of death”
  1. Enable debugging (see above)
  2. Increase memory
  3. Disable plugins via FTP: rename /plugins/ to /plugins-disabled/

Still Stuck?

Section titled “Still Stuck?”

Before Contacting Support

Section titled “Before Contacting Support”

Gather this info:

  • WordPress version (Dashboard > Updates)
  • BuddyX Pro version (Appearance > Themes)
  • PHP version (Tools > Site Health > Info > Server)
  • Screenshot of issue
  • Steps to reproduce

Contact Support

Section titled “Contact Support”

Email: support@wbcomdesigns.com

See Before Contacting Support for checklist.

Section titled “Related”