Function and usage of has_image_size() in wordpress


Answers ( 1 )


    The has_image_size() function in WordPress is used to determine if a specified image size exists within the WordPress installation. This function is particularly useful when working with custom image sizes or when you want to ensure that a certain size is available for use in your theme or plugin.

    Function Definition

    has_image_size( string $name ): bool


    • $name (string, required): This parameter is the name of the image size you want to check. WordPress has several default image sizes like 'thumbnail', 'medium', 'large', etc. You can also check for custom image sizes that are defined using add_image_size() function.

    Return Value

    • bool: This function returns a boolean value. It returns true if the specified image size exists, and false if it does not.

    Sample Usage

    Checking a Default Image Size

    if ( has_image_size( 'thumbnail' ) ) {
        echo 'Thumbnail size exists.';
    } else {
        echo 'Thumbnail size does not exist.';

    In this example, the function checks if the default 'thumbnail' size is available.

    Checking a Custom Image Size

    // Adding a custom image size
    add_image_size( 'custom-size', 220, 180, true );
    // Later in the code
    if ( has_image_size( 'custom-size' ) ) {
        echo 'Custom size exists.';
    } else {
        echo 'Custom size does not exist.';

    Here, a custom image size named 'custom-size' is first added. Later, has_image_size() checks if this custom size is available.

    Use Cases

    1. Theme Development: When developing a theme, you might want to check if certain image sizes are available before using them for thumbnails or featured images.

    2. Plugin Development: If your plugin relies on specific image sizes, using has_image_size() can help ensure that these sizes are available or prompt the user to generate them.

    3. Conditional Image Handling: In cases where different image sizes are used for different layouts or devices, you can use this function to check the availability of these sizes and handle images accordingly.

    Remember that this function only checks if a size is registered in WordPress; it doesn't check if images of that size are actually generated for every image in the media library.

Leave an answer