Troubleshooting

Quick fix: the killswitch

If your site is broken and you need to fix it immediately:

1. Toggle the killswitch in the BoostPro sidebar widget to disable all optimizations instantly
2. If you cannot access the admin, add this to wp-config.php:

define('BOOST_DISABLE', true);

This confirms whether BoostPro is causing the issue. Your individual settings are preserved and restored when you turn the killswitch off.

Site looks broken or unstyled

Likely cause: Remove Unused CSS is stripping needed styles that were not detected during analysis.

Fix:

1. Go to the Advanced tab, either disable Remove Unused CSS or add the affected stylesheet to exclusions
2. If specific elements are broken, add their CSS selectors to the excluded selectors list
3. Nuclear option: change the stylesheet behavior from "Remove" to "Async" (keeps the original stylesheets as a safety net)

JavaScript errors or broken functionality

Likely cause: JS defer or delay is interfering with script execution order.

Fix:

1. Open your browser console (F12 → Console) and identify the failing script
2. For deferred scripts: add the handle to defer exclusions
3. For delayed scripts: add the handle or URL to delay exclusions, or use a quick exclusion preset
4. Last resort: disable JS delay/defer for this specific page via the Resource Manager

Slider, form, or modal not working

Likely cause: JavaScript delay is preventing the script from loading until user interaction.

Fix: The script needs to run on page load, not on interaction. Add it to delay exclusions.

Common presets cover: Google reCAPTCHA, Elementor, WooCommerce, Contact Form 7, and 24+ more. Check the delay exclusion presets before adding custom exclusions.

Images not appearing

Likely cause: Lazy loading or image optimization delivery issue.

Fix:

• Lazy loading: check if above-the-fold images are being lazily loaded. Increase the skip count so the first visible images load immediately.
• Exclude patterns: add the image URL pattern to lazy load exclusions
• Image optimization: verify converted files exist in /wp-content/boost-images/uploads/
• Delivery method: if using the .htaccess delivery method on Nginx, switch to picture tags

Fonts loading slowly or FOUT visible

Font-display: swap causes a brief flash of unstyled text (FOUT). This is expected and actually preferred over invisible text (FOIT), since visitors can read content immediately while fonts load.

If FOUT is too noticeable:

• Enable font preloading to reduce the swap delay
• For self-hosted fonts, verify that /wp-content/uploads/boost-fonts/ contains .woff2 files

PageSpeed score not improving

• Server response time (TTFB): this is a server-side metric that BoostPro cannot fix. Consider better hosting.
• Third-party scripts: BoostPro can defer and delay them but cannot eliminate them. Reduce your third-party script count where possible.
• Large images: enable image optimization and use the Balanced or Aggressive quality preset
• Missing cache: ensure page caching is enabled and working (check cache stats on the dashboard)

Database cleanup not running

WordPress cron depends on site visits. Low-traffic sites may not trigger cron reliably.

Fix: set up a real server cron job:

*/15 * * * * curl -s https://yoursite.com/wp-cron.php > /dev/null 2>&1

Or run a manual cleanup from the Cleanup tab.

Conflict with another plugin

1. Check the Tools tab for detected conflicts
2. Deactivate the conflicting plugin using the one-click link
3. If no conflict is detected but issues persist: deactivate all other plugins, then re-enable them one at a time to isolate the conflict

Common conflicts: multiple caching plugins, multiple image optimizers, multiple minification plugins. See Plugin Compatibility for the full list.

Identifying the problem feature

1. Enable the killswitch to confirm BoostPro is the cause
2. Disable the killswitch
3. Disable features one at a time, starting with the most aggressive: Remove Unused CSS, JS Delay, JS Defer, JS Minify, CSS Minify
4. After each toggle, clear cache and test
5. Once identified, check the relevant article for exclusion options

Clearing all caches

1. Purge BoostPro cache (Dashboard or admin bar)
2. Clear used CSS cache (Advanced tab or admin bar)
3. Clear browser cache (Ctrl+Shift+R / Cmd+Shift+R)
4. If using Cloudflare: purge Cloudflare cache
5. If using server caching: purge server cache

Getting help

If you have tried the steps above and still have issues, please gather the following before contacting support:

• WordPress version
• PHP version
• Server type (Apache, Nginx, LiteSpeed, etc.)
• Active plugins list
• Steps to reproduce the issue

Contact us at srworks.co/contact/ with this information and we will help you resolve the issue.