On This Page
v 1.0.0
Last updated: 16/03/2026
Quick Debug Toggle
Enable or disable WordPress debug mode directly from the admin panel without editing wp-config.php. Perfect for developers who need to quickly troubleshoot issues without FTP access or file editing.
Overview
Quick Debug Toggle adds an admin bar item to enable or disable WordPress debug mode (WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY) without editing wp-config.php. One-click toggle. Useful when troubleshooting errors. Only visible to users with manage_options. When enabled, errors are logged to wp-content/debug.log (or displayed if WP_DEBUG_DISPLAY is on). Disable when done to avoid exposing errors on production.
Who is this for?
Developers and site owners who need to quickly enable debug mode to troubleshoot errors, without manually editing wp-config.php.
Features
Admin Bar Toggle
Click the admin bar item to enable or disable debug mode. No file editing.
WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY
Toggles these constants. Typically stored in options or written to wp-config.php (implementation may vary).
Capability Check
Only users with manage_options see the toggle. Secure.
How It Works
1
Enable the Module
Go to WP PowerSuite, find "Quick Debug Toggle," and click the Enable button.
2
Use the Toggle
When logged in as admin, look at the admin bar. Click the debug toggle to enable or disable. Refresh the page if needed.
3
Check Logs
When debug is on, errors are logged to wp-content/debug.log (or displayed if configured). Disable when done.
Performance Note
Minimal. Admin bar item only. Debug mode itself can slow the site and expose errors—use only when troubleshooting. Always disable on production when not debugging.
Installation & Activation
1
Install WP PowerSuite
Make sure the WP PowerSuite plugin is installed and activated on your site.
2
Enable the Module
Go to the WP PowerSuite menu, find "Quick Debug Toggle" in the module list, and click the Enable button.
3
Use the Toggle
Use the admin bar to enable/disable debug as needed.
Requirements
PHP 8.1 or higher
WordPress 6.0 or higher
Permission to manage options (Administrator)
Writable wp-config.php (if the module writes to it) or alternative storage for debug state
Use Cases
- ErrorDebuggingTroubleshooting PHP errors
- PluginTroubleshootingDebugging plugin or theme issues
- DebugControlQuick enable/disable without FTP or file editor
Frequently Asked Questions
Where are errors logged?
Typically wp-content/debug.log when WP_DEBUG_LOG is true. Ensure the file is writable. Check your host’s documentation if logs don’t appear.
Is it safe to leave debug on?
No. On production, disable when not debugging. Debug mode can expose sensitive information and affect performance.
Troubleshooting
- Toggle not appearingEnsure you're logged in as Administrator (manage_options). Check that the module is enabled. Refresh the page.