One of the most stressful experiences for a website owner is trying to fix a “broken” site while visitors are actively using it. Traditionally, testing for plugin conflicts meant disabling your entire site’s functionality for everyone.
The Troubleshooting plugin (part of the Health Check & Troubleshooting suite) solves this by creating a “virtual sandbox” for administrators. It allows you to deactivate plugins and switch themes only for your own session, while your customers and readers continue to see the fully functional site.
Table of Contents
What is the Troubleshooting Plugin?
Troubleshooting mode is a specialized diagnostic environment for WordPress. Developed by the community and contributors like Marius LJ, it was designed to prevent the “site under construction” downtime usually required for debugging.
- Admin-Only Isolation: Changes made in this mode are strictly local to your browser session.
- Conflict Detection: It is the fastest way to determine if a specific plugin or your theme is causing a “Fatal Error” or layout issue on your mybox hosted site.
- Lightweight: It doesn’t modify your database or permanently change your site settings.
How Diagnostic Mode Works
When you enter Troubleshooting Mode, WordPress “tricks” the site into thinking all plugins are deactivated and a default theme (like Twenty Twenty-Four) is active.
- For You: The site looks like a fresh, empty installation.
- For Everyone Else: The site remains exactly as it was, with all professional themes and plugins running normally.
This isolation allows you to systematically turn plugins back on one by one until the error reappears. Once it does, you have found the culprit.
Installation and Activation
The Troubleshooting features are included in the Health Check & Troubleshooting plugin, which is a must-have for any mybox administrator.
- Log in to your WordPress dashboard.
- Go to Plugins > Add New.
- Search for “Health Check & Troubleshooting”.
- Click Install and then Activate.
- Navigate to Tools > Site Health > Troubleshooting.
Running a Diagnostic Session
To begin finding the cause of your site’s issues:
- Enable Troubleshooting Mode: Click the button to start the session. Your site will immediately revert to a default state (for you only).
- Test the Core: Check if the error still exists. If the site is now working perfectly, you know the issue is not with WordPress core, but with a plugin or your theme.
- Check the Theme: In the top admin bar, use the “Troubleshooting” menu to switch back to your active theme. If the error returns, the theme is the problem.
- Check Plugins: If the theme is fine, start enabling your plugins one by one from the “Available Plugins” list in the Troubleshooting menu. Test the site after each activation.
- Identify the Culprit: When the error returns, the last plugin you enabled is the source of the conflict.
Exiting and Cleanup
Once you have identified the problematic plugin or theme:
- Click Exit Troubleshooting Mode in the top admin bar.
- Your session will end, and your view of the site will return to normal.
- Pro Tip: Because you are on mybox infrastructure, remember to clear your server-side cache (like LiteSpeed) or browser cache after exiting to ensure you are seeing the live, “real” state of the site.
Best Practices
- Caching Plugins: Sometimes caching plugins can interfere with the “isolation” of Troubleshooting mode. If you see strange behavior, temporarily deactivate your caching plugin before entering the mode.
- Managed Updates: Once you find a faulty plugin, check if an update is available or if it is compatible with your current PHP version (e.g., PHP 8.1+).
- Systematic Approach: Always enable plugins one at a time. Enabling them in groups makes it impossible to know exactly which one caused the crash.
Summary
The Troubleshooting plugin is the “safety net” for WordPress maintenance. It turns a high-risk debugging process into a secure, private exercise. By using this tool on your mybox server, you can maintain a professional image for your visitors while solving technical headaches behind the scenes.