WP Debug Toolkit (WPDT) places the WP Debug Toolkit menu entry at the top level of the WordPress admin sidebar by default. To move it, navigate to WP Debug Toolkit › Settings › Admin UI, expand Menu Location, and select your preferred position. To control the position in code, write the wpdebugtoolkit_menu_location option using update_option() before the plugin registers its menu.
Moving the WP Debug Toolkit menu entry under the WordPress Tools submenu reduces sidebar clutter without removing access to any features.
✅ What You Should See: WPDT displays a prompt asking you to reload the page. Click Reload Now and the WP Debug Toolkit menu entry will appear in its new location after that reload.
To control the position in code instead, add the following to your theme’s functions.php file or a code snippet plugin:
php
add_action( 'after_setup_theme', function () {
// Valid values: 'tools' (Tools submenu) or 'top-level' (default top-level menu).
update_option( 'wpdebugtoolkit_menu_location', 'tools' );
// To restore the default top-level position, replace 'tools' with 'top-level' above.
}, 1 );The UI setting and the code approach write to the same database option, wpdebugtoolkit_menu_location, which accepts exactly two values: ‘tools’ (Tools submenu) or ‘top-level’ (default).
Because the snippet runs on every request via after_setup_theme, the code always wins. If someone changes the position through WP Debug Toolkit › Settings › Admin UI, the next page load resets it back to whatever value the code defines. Use one approach or the other: the UI setting for manual control, the code snippet for sites where you want the position locked regardless of what is saved in the admin.
✅ What You Should See: After adding the code and reloading wp-admin once, the WP Debug Toolkit menu entry appears in its new location.
No. The setting controls only where the WP Debug Toolkit entry appears in the sidebar. All features and data remain fully accessible regardless of which position you choose.
Yes. The menu location is stored in the WordPress database and survives plugin updates. If you use the code approach, the value is enforced on every request, so plugin updates cannot change it.
Activating and Deactivating Your License – Understand how WPDT licensing works and confirm your license is active
How to Automatically Enable WordPress Debug Mode – Manage WordPress debug constants from wp-admin without editing files manually.
