Title: Black Bar Author: Gemini Labs Published: February 22, 2018 Last modified: December 1, 2025 --- Search plugins ![](https://ps.w.org/blackbar/assets/banner-772x250.png?rev=2864188) ![](https://ps.w.org/blackbar/assets/icon-256x256.png?rev=2864188) # Black Bar By [Gemini Labs](https://profiles.wordpress.org/geminilabs/) [Download](https://downloads.wordpress.org/plugin/blackbar.4.1.4.zip) * [Details](https://pcd.wordpress.org/plugins/blackbar/#description) * [Reviews](https://pcd.wordpress.org/plugins/blackbar/#reviews) * [Installation](https://pcd.wordpress.org/plugins/blackbar/#installation) * [Development](https://pcd.wordpress.org/plugins/blackbar/#developers) [Support](https://wordpress.org/support/plugin/blackbar/) ## Description Black Bar is an unobtrusive Debug Bar for WordPress developers. It collects and displays errors, executed SQL queries, slow actions and hooks, theme templates, global variables, and provides a profiler. How it helps you with development: * Debug your code with the Console * Inspect global variables (COOKIE, GET, POST, SERVER, SESSION, WP_Screen) * Measure performance of your code with the Profiler * View any PHP errors that occur when loading a page in the Console * View executed MySQL queries along with execution time and backtrace * View template files of the active theme in loaded order * View the 50 slowest action and filter hooks along with callbacks ordered by priority ## Installation If you have never installed a WordPress plugin before, you can [read instructions on how to do this here](https://wordpress.org/documentation/article/manage-plugins/). ## FAQ ### How do I add entries to the Console? To add entries to the console, insert the following line of PHP anywhere in your code: ``` do_action('console', 'Enter something to debug here'); ``` You can also add an optional log level like this: ``` do_action('console', 'Enter something to debug here', 'error'); ``` The available log levels are: `debug`, `info`, `notice`, `warning`, `error`, `critical`,` alert`, and `emergency`. ### How do I use the Profiler? To use the profiler, insert the following lines of PHP _before_ and _after_ the code you are profiling: _Before:_ ``` do_action('timer:start', 'Enter a description of what you are profiling here'); ``` _After:_ ``` do_action('timer:stop'); ``` ### How do I enable the plugin for non-administrators? By default, Black Bar is only visible to administrator users. To enable it for all logged-in users, use this code snippet: ``` add_filter('blackbar/enabled', 'is_user_logged_in'); ``` ### How do I change the number of slowest hooks displayed? By default, Black Bar displays the 50 slowest action/filter hooks. To display all hooks, use this code snippet: ``` add_filter('blackbar/hooks/all', '__return_true'); ``` ## Reviews ![](https://secure.gravatar.com/avatar/723b9723a653693a60c038fde33204022837df98f30362e638e59774a06d0c34? s=60&d=retro&r=g) ### 󠀁[Useful and easy to use](https://wordpress.org/support/topic/useful-and-easy-to-use-70/)󠁿 [theunnicked](https://profiles.wordpress.org/theunnicked/) February 15, 2026 This plugin allowed me to pinpoint performance issues, not only within my code, but also in used plugins that were not optimised enough. ![](https://secure.gravatar.com/avatar/a8a7f02dc4a71b4d38fd8d07cb400f27f81a7e7a1684b4fa808af76dfbc7e4d3? s=60&d=retro&r=g) ### 󠀁[Great tool](https://wordpress.org/support/topic/great-tool-2103/)󠁿 [xorinzor](https://profiles.wordpress.org/xorinzor/) April 25, 2024 Was wondering why my wordpress installation was unbearably slow. This plugin helped me discover the massive amount of SQL queries generated by 2 conflicting plugin settings. Problem solved! ![](https://secure.gravatar.com/avatar/7d6fa1b5f32586104b1328b7a744e2c85ba9c27f7e80b6e3691c88955a7de6ea? s=60&d=retro&r=g) ### 󠀁[i like it](https://wordpress.org/support/topic/i-like-it-975/)󠁿 [ajaxStardust](https://profiles.wordpress.org/ajaxstardust/) February 4, 2023 nice. thanks for updating. i prefer this extension for debugging. ![](https://secure.gravatar.com/avatar/44bdb8a692d4590c0d38a3360128936e5793430074fd29914f516aa7c3db96df? s=60&d=retro&r=g) ### 󠀁[Indispensable / Essential](https://wordpress.org/support/topic/indispensable-essential/)󠁿 [informatux](https://profiles.wordpress.org/informatux/) April 14, 2020 Il fait l’affaire haut la main, parfait 😉 It did the trick, perfect 😉 ![](https://secure.gravatar.com/avatar/856e8066daaed849844c6bd0f17da05869aa048e79c0340b5b9268198be706f0? s=60&d=retro&r=g) ### 󠀁[Developer must have](https://wordpress.org/support/topic/developer-must-have/)󠁿 [Anna Bansaghi](https://profiles.wordpress.org/annabansaghi/) July 23, 2019 1 reply Thank you for giving new life to BlackBox Debug Bar! Not only the usefulness of this plugin, but the beautiful PHP coding leads me to write this review. I have learnt a lot from your code. ![](https://secure.gravatar.com/avatar/6cce48d5b3d8e19f5985ef7e189d6e98031d4059c73b9a2428f42a5b533c95a2? s=60&d=retro&r=g) ### 󠀁[Beautiful way to show the data.](https://wordpress.org/support/topic/beautiful-way-to-show-the-data/)󠁿 [Lenin Zapata ☄](https://profiles.wordpress.org/ilenstudio/) March 28, 2019 This is a beautiful way to interpress the data, I am a developer and this plugin helped me correct errors, I really feel very inspired. Thanks for the idea. [ Read all 9 reviews ](https://wordpress.org/support/plugin/blackbar/reviews/) ## Contributors & Developers “Black Bar” is open source software. The following people have contributed to this plugin. Contributors * [ Gemini Labs ](https://profiles.wordpress.org/geminilabs/) * [ Paul ](https://profiles.wordpress.org/pryley/) “Black Bar” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/blackbar/contributors) for their contributions. [Translate “Black Bar” into your language.](https://translate.wordpress.org/projects/wp-plugins/blackbar) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/blackbar/), check out the [SVN repository](https://plugins.svn.wordpress.org/blackbar/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/blackbar/) by [RSS](https://plugins.trac.wordpress.org/log/blackbar/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 4.1.4 (2024-05-08) * Added “blackbar/hooks/all” filter hook * Added highlighting of major WordPress hooks * Added support for static callables used for hook callbacks in Site Reviews * Change minimum PHP version to 7.4 * Change minimum WordPress version to 6.1 #### 4.1.3 (2024-05-08) * Added “blackbar/hooks/all” filter hook * Added highlighting of major WordPress hooks * Added support for static callables used for hook callbacks in Site Reviews * Change minimum PHP version to 7.4 * Change minimum WordPress version to 6.1 #### 4.1.2 (2024-05-08) * Added “blackbar/hooks/all” filter hook * Added highlighting of major WordPress hooks * Added support for static callables used for hook callbacks in Site Reviews * Change minimum PHP version to 7.4 * Change minimum WordPress version to 6.1 #### 4.1.1 (2024-05-08) * Added “blackbar/hooks/all” filter hook * Added highlighting of major WordPress hooks * Added support for static callables used for hook callbacks in Site Reviews * Change minimum PHP version to 7.4 * Change minimum WordPress version to 6.1 #### 4.1.0 (2024-05-08) * Added “blackbar/hooks/all” filter hook * Added highlighting of major WordPress hooks * Added support for static callables used for hook callbacks in Site Reviews * Change minimum PHP version to 7.4 * Change minimum WordPress version to 6.1 #### 4.0.3 (2023-10-11) * Fixed debugging of non-scalar values * Fixed display of console values with an Unknown log level #### 4.0.2 (2023-09-18) * Fixed PHP 7 support * Fixed console values which include HTML #### 4.0.1 (2023-03-04) * Added cache busting to enqueued assets * Added console level filter counts * Added HTTP_COOKIE value to INPUT_SERVER globals #### 4.0.0 (2023-02-13) * Added console level filters * Added sorting to Action/Filter Hooks * Added syntax highlighting to console entries * Added trace information to SQL queries * Beautified SQL formating * Changed Profiler usage (use the “timer:start” and “timer:stop” hooks) * Improved Profiler, it is now also more accurate * Refreshed UI * Requires PHP >= 7.3 [See changelog for all versions](https://raw.githubusercontent.com/pryley/blackbar/main/changelog.txt). ## Meta * Version **4.1.4** * Last updated **4 months ago** * Active installations **600+** * WordPress version ** 6.1 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/blackbar/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/blackbar/), and [English (US)](https://wordpress.org/plugins/blackbar/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/blackbar) * Tags * [debug](https://pcd.wordpress.org/plugins/tags/debug/)[debug bar](https://pcd.wordpress.org/plugins/tags/debug-bar/) [debugbar](https://pcd.wordpress.org/plugins/tags/debugbar/)[development](https://pcd.wordpress.org/plugins/tags/development/) * [Advanced View](https://pcd.wordpress.org/plugins/blackbar/advanced/) ## Ratings 5 out of 5 stars. * [ 9 5-star reviews ](https://wordpress.org/support/plugin/blackbar/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/blackbar/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/blackbar/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/blackbar/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/blackbar/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/blackbar/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/blackbar/reviews/) ## Contributors * [ Gemini Labs ](https://profiles.wordpress.org/geminilabs/) * [ Paul ](https://profiles.wordpress.org/pryley/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/blackbar/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://ko-fi.com/pryley)