BuddyX
Get BuddyX Pro

Troubleshooting

Free & Pro

Quick solutions to common BuddyX Pro issues.

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

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

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

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

  1. Disable security plugins temporarily
  2. Clear all caches
  3. Try different browser

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

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

  1. Verify WooCommerce is active
  2. Customize > Site Header > Header Elements
  3. Toggle Site Cart to On

Logo wrong size

Customize > Site Identity > Logo Width

Or add CSS:

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

Sticky header not working

  1. Customize > Site Header > Sticky Header
  2. Toggle Enable Sticky Header to On
  3. Clear cache

BuddyPress Issues

Members page 404

  1. Settings > Permalinks
  2. Click Save Changes (don't change anything)

"Requires BP Nouveau" error

  1. Settings > BuddyPress > Options
  2. Select BP Nouveau under Template Pack
  3. Save

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

  1. Check PHP upload limit (need 10MB+)
  2. Check folder permissions: chmod 755 wp-content/uploads

WooCommerce Issues

Shop page 404

  1. WooCommerce > Settings > Products
  2. Verify Shop Page is assigned
  3. Settings > Permalinks > Save Changes

Mini-cart not opening

  1. Clear all caches
  2. Disable JS minification
  3. Check browser console for errors

Performance Issues

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

  1. Increase PHP memory to 256MB
  2. Reduce Google Fonts loaded
  3. Disable admin-heavy plugins temporarily

Memory exhausted errors

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

Dark Mode Issues

Toggle not appearing

  1. Customize > Site Skin > Color Mode
  2. Toggle Dark Mode Toggle to On
  3. Clear cache

Dark mode colors wrong

Customize > Site Skin > Dark Mode Colors

Configure:

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

Mobile Issues

Elements overlapping

  1. Check custom CSS isn't breaking mobile
  2. Add mobile-specific CSS:
@media (max-width: 767px) {
    /* Your fixes */
}

Text too small

Customize > Typography > Body Typography

Increase font size, or add CSS:

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

Error Messages

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

  1. Verify credentials in wp-config.php
  2. Contact host - database server may be down

White screen of death

  1. Enable debugging (see above)
  2. Increase memory
  3. Disable plugins via FTP: rename /plugins/ to /plugins-disabled/

Still Stuck?

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

Email: support@wbcomdesigns.com

See Before Contacting Support for checklist.

Related