Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/show admin bar


Set the display status of the Toolbar for the front side of your website (you cannot turn off the toolbar on the WordPress dashboard).

Note: The Admin Bar is replaced with the Toolbar since WordPress Version 3.3.


<?php show_admin_bar( $bool ); ?>


(boolean) (required) Whether to show the Toolbar.
Default: None

Return Values



This function should be called immediately upon plugin load or placed in the theme's functions.php file.

This function will also affect the display of the Toolbar in the dashboard for WordPress versions prior to Version 3.3.


show_admin_bar( false );

Placing the above line of code in theme's functions.php file will prevent the Toolbar from rendering on the front end of your site.

You can also determine for which users the admin bar is shown. For example the following lines will only display the admin bar for users with administrative privileges.

if ( ! current_user_can( 'manage_options' ) ) {
    show_admin_bar( false );

With newer version of WordPress you may need to use the following which will leave the Toolbar available in the Dashboard but hide it on all front facing pages.

add_filter('show_admin_bar', '__return_false');

Change Log

Source File

show_admin_bar() is located in wp-includes/admin-bar.php.


See also index of Function Reference and index of Template Tags.