Function and usage of dismiss_core_update() in wordpress


Answers ( 1 )


    The dismiss_core_update() function in WordPress is used to dismiss a core update that is being offered to the WordPress installation. This is particularly useful in scenarios where a site administrator chooses not to update to the latest WordPress version immediately, possibly due to compatibility issues with themes or plugins, or other strategic reasons. Here's a detailed explanation:


    dismiss_core_update( object $update ): bool


    • $update (object) (Required): This parameter is an object representing the core update that is to be dismissed.


    • The function's primary role is to dismiss a core update notification from the WordPress dashboard.
    • It changes the site's internal records to indicate that the specified update has been dismissed.
    • This prevents WordPress from repeatedly notifying the administrator of the same update.
    • The dismissal is typically for a specific version. If a new update is released, it will appear as a new notification.

    Return Value:

    • bool: The function returns a boolean value.
      • true if the update was successfully dismissed.
      • false if the dismissal failed, for example, if the specified $update object is not valid or if there was a problem in updating the site's records.

    Sample Usage:

    Here's a hypothetical example of how dismiss_core_update() might be used:

    // Example of a core update object
    $core_update = (object) array(
        'response'      => 'latest',
        'download'      => '',
        'locale'        => 'en_US',
        'packages'      => null,
        'current'       => '5.8',
        'php_version'   => '5.6.20',
        'mysql_version' => '5.0',
        'new_bundled'   => '5.8',
        'partial_version' => '',
        'dismissed'     => false
    // Dismiss the specified core update
    $result = dismiss_core_update($core_update);
    if ($result) {
        echo "Update dismissed successfully.";
    } else {
        echo "Failed to dismiss the update.";

    In this example, an update object is created manually (though in a real-world scenario, this would likely be obtained from the WordPress core update API). The dismiss_core_update() function is then called with this object, and the result is checked. If the dismissal is successful, a success message is displayed; otherwise, a failure message is shown.


    • This function is part of the WordPress core and is typically used by plugins or themes that need fine-grained control over update notifications and behaviors.
    • It's important to use this function responsibly, as dismissing updates can lead to security vulnerabilities if not managed properly.

Leave an answer