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

Plugin API/Action Reference/admin head-(plugin page)


The admin_head-(plugin_page) hook is triggered within the <head></head> section of a specific plugin-generated page.

This hook provides no parameters. You use this hook by having your function echo output to the browser, or by having it perform background tasks. Your functions shouldn't return, and shouldn't take any parameters.




add_action('admin_head-HOOK_SUFFIX', 'myplugin_adminhead');
function myplugin_adminhead() {
    // Output <head> content here, e.g.:

Where HOOK_SUFFIX is the plugin's hook suffix as returned by add_submenu_page or one of its siblings add_options_page or add_management_page.


Tools pages

To add <head></head> content to a management page, the suffix for this hook should be in the following form:

add_action('admin_head-tools_page_myplugin/myplugin', 'myplugin_adminhead');
function myplugin_adminhead() {
    // Output <head> content here, e.g.:
    echo '<style type="text/css">'
         .'/* ... */'

Options pages

This hook is an action which means that it primarily acts as an event trigger, instead of a content filter. This is a semantic difference, but it will help you to remember what this hook does if you use it like this:

add_action( 'admin_menu', 'myplugin_setup_options' );

function myplugin_setup_options(){
  $plugin_page=add_options_page( 'My Plugin', 'myplugin', 8, basename(__FILE__), 'myplugin_main' );
  add_action( 'admin_head-'. $plugin_page, 'myplugin_admin_header' );

function myplugin_admin_header(){
  echo '<p>Only executes when the myplugin options page is displayed.</p>';