WordPress at a glance
action is not described

load-(page_hook) action-hook . WP 2.1.0

Fires before a particular screen is loaded.

The load-* hook fires in a number of contexts. This hook is for plugin screens where a callback is provided when the screen is registered.

The dynamic portion of the hook name, $page_hook, refers to a mixture of plugin page information including:

  1. The page type. If the plugin page is registered as a submenu page, such as for Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'.
  2. A separator of '_page_'.
  3. The plugin basename minus the file extension.

Together, the three parts form the $page_hook. Citing the example above, the hook name used would be 'load-settings_page_pluginbasename'.


add_action( 'load-(page_hook)', 'action_function_name_2295' );
function action_function_name_2295(){
	// action...


Since 2.1.0 Introduced.

Where the hook is called

In file: /wp-admin/admin.php
wp-admin/admin.php 232
do_action( "load-{$page_hook}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

Where in WP core the hook is used

wp-admin/includes/admin-filters.php 111
add_action( 'load-plugins.php', 'wp_plugin_update_rows', 20 ); // After wp_update_plugins() is called.
wp-admin/includes/admin-filters.php 112
add_action( 'load-themes.php', 'wp_theme_update_rows', 20 ); // After wp_update_themes() is called.
wp-admin/includes/class-custom-background.php 70
add_action( "load-{$page}", array( $this, 'admin_load' ) );
wp-admin/includes/class-custom-background.php 71
add_action( "load-{$page}", array( $this, 'take_action' ), 49 );
wp-admin/includes/class-custom-background.php 72
add_action( "load-{$page}", array( $this, 'handle_upload' ), 49 );
wp-includes/update.php 820
add_action( 'load-plugins.php', 'wp_update_plugins' );
wp-includes/update.php 821
add_action( 'load-update.php', 'wp_update_plugins' );
wp-includes/update.php 822
add_action( 'load-update-core.php', 'wp_update_plugins' );
wp-includes/update.php 826
add_action( 'load-themes.php', 'wp_update_themes' );
wp-includes/update.php 827
add_action( 'load-update.php', 'wp_update_themes' );
wp-includes/update.php 828
add_action( 'load-update-core.php', 'wp_update_themes' );