Home » Hooks » image_size_names_choose

WordPress Hook: image_size_names_choose

In the world of WordPress, hooks play a vital role in modifying and extending the functionality of the platform. One such hook is the "image_size_names_choose" hook. This hook allows developers to modify the list of available image sizes when inserting an image into a post or page using the Media Library.

By default, WordPress provides a set of pre-defined image sizes such as thumbnail, medium, large, and full. However, there may be instances where you want to customize the list of available sizes to better suit your needs or the specific requirements of your website.

The "image_size_names_choose" hook is typically used to add or remove custom image sizes from the dropdown menu that appears in the Media Library when selecting an image size. This allows you to provide more options to content creators and ensure that they can easily select the appropriate image size for their needs.

Let’s take a look at an example usage of the "image_size_names_choose" hook:

function custom_image_sizes( $sizes ) {
    // Add a custom image size to the dropdown menu
    $sizes['custom-size'] = __( 'Custom Size' );

    // Remove the medium-size option from the dropdown menu
    unset( $sizes['medium'] );

    return $sizes;
add_filter( 'image_size_names_choose', 'custom_image_sizes' );

In this example, we define a custom function called "custom_image_sizes" which takes the existing image sizes as an argument. Within this function, we add a new custom image size called "custom-size" to the dropdown menu by appending it to the array of sizes. We also remove the "medium" size option from the dropdown menu by using the "unset" function.

Finally, we hook our custom function "custom_image_sizes" to the "image_size_names_choose" filter using the "add_filter" function. This ensures that our function will be executed at the appropriate time and modify the available image sizes accordingly.

By using the "image_size_names_choose" hook, you have the power to customize the list of available image sizes in the Media Library, providing a more tailored experience for content creators and users on your WordPress site.

Learn More on

Register an account to save your snippets or go Pro to get more features.