PluginsArmorProCitedProBoostPro
PricingDocsBlogAboutGet Started

Troubleshooting

Common issues and how to resolve them.

Last updated Feb 6, 2026

Quick Fix: The Killswitch

If your site is broken and you need to fix it immediately, use the killswitch:

  1. Go to BoostPro → Advanced and toggle Disable All Optimizations to On
  2. If you can't access the admin, add this to wp-config.php:
define('BOOST_KILLSWITCH', true);

This instantly disables all BoostPro optimizations without changing your settings. Once you've identified the issue, turn the killswitch off and your settings are restored.

Common Issues

Site Looks Broken or Unstyled

Cause: Remove Unused CSS is stripping styles that are needed but weren't detected during analysis (e.g. styles added by JavaScript).

Fix:

  1. Switch the stylesheet behavior to Async (loads the full stylesheets as a safety net)
  2. Add any missing CSS selectors to the safelist in BoostPro → Advanced (e.g. .menu-open, .modal-visible)
  3. If the issue persists, exclude the problematic stylesheet from unused CSS removal

JavaScript Errors or Broken Functionality

Cause: A script that doesn't work when deferred or delayed.

Fix:

  1. Open your browser console (F12 → Console) and note the error
  2. Identify which script is failing
  3. Add its handle or URL pattern to the JS exclusion list in BoostPro → Advanced
  4. Clear your cache and test again

Slider, Form, or Modal Not Working

Cause: The element's JavaScript is being deferred or delayed.

Fix: Add the script to the JS defer/delay exclusion list. Common patterns to exclude:

slider
swiper
carousel
contact-form
wpcf7
popup
modal

Images Not Appearing

Cause: Above-the-fold images are being lazy-loaded when they shouldn't be.

Fix: Increase the above-fold skip count in BoostPro → Optimization. If the first 3 images on your page aren't loading, set the skip count to 3 or higher.

Fonts Loading Slowly or Changing Mid-Load

Cause: Font display swap showing a fallback font briefly, or self-hosted fonts not cached yet.

Fix:

  • This is expected behavior with font display swap (FOUT is preferred over invisible text)
  • If self-hosted fonts are slow on first load, refresh the page. The cache will serve them instantly after the first download.
  • Enable font preloading for the fastest possible font delivery

PageSpeed Score Not Improving

Possible causes:

  • Caching: Clear all caches (BoostPro, page cache, CDN) after changing settings
  • Server speed: TTFB issues are server-side and not affected by frontend optimizations
  • Large images: Optimize image file sizes separately (BoostPro handles loading, not compression)
  • Third-party scripts: Analytics, ads, and chat widgets affect scores. Use JS delay to mitigate.

Database Cleanup Not Working

Cause: WordPress cron may not be running.

Fix:

  • Verify WordPress cron is working: install the WP Crontrol plugin to inspect scheduled events
  • If using a system cron instead of WordPress cron, make sure it's calling wp-cron.php
  • Run a manual cleanup from BoostPro → Cleanup to verify it works

Conflict with Another Performance Plugin

Fix:

  1. Run the conflict scanner in BoostPro → Tools
  2. Review which features overlap
  3. Disable the overlapping feature in one plugin or the other
  4. Clear all caches

See Plugin Compatibility for detailed conflict info →

Per-page disable controls

If an issue only affects specific pages, you don't need to disable a feature site-wide. BoostPro adds a meta box to the post/page editor where you can selectively disable features for that page:

  • Delay JavaScript
  • Defer JavaScript
  • Remove Unused CSS
  • CSS Minification
  • JS Minification
  • Page Caching

Look for the "BoostPro" meta box in the page or post editor sidebar.

Identifying the problem feature

If you're not sure which BoostPro feature is causing an issue:

  1. Enable the killswitch to confirm BoostPro is the cause
  2. Disable the killswitch
  3. Turn off all Advanced features (minification, defer, delay, remove unused CSS)
  4. Re-enable them one at a time, testing after each
  5. When the issue reappears, you've found the culprit
  6. If the issue is page-specific, use per-page disable controls instead of disabling the feature globally

Clearing Caches

After changing BoostPro settings, always clear these caches:

  1. BoostPro caches: CSS minification cache clears automatically on settings change
  2. Page cache: BoostPro automatically purges supported caching plugins on save
  3. CDN cache: Purge your CDN (Cloudflare, etc.) if you have one
  4. Browser cache: Hard refresh (Ctrl+Shift+R or Cmd+Shift+R) or test in incognito

Getting Help

If you've tried the steps above and still have issues:

  • Note which BoostPro features are enabled
  • Note any error messages from the browser console
  • Note your WordPress version and active theme
  • Contact us with this information and we'll help you resolve the issue
Previous← WP-CLI Commands