Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_set_cron_array( array[] $cron, bool $wp_error = false ): bool|WP_Error

Updates the cron option with the new cron array.


$cron array[] Required
Array of cron info arrays from _get_cron_array() .
$wp_error bool Optional
Whether to return a WP_Error on failure.

Default: false

Top ↑


bool|WP_Error True if cron array updated. False or WP_Error on failure.

Top ↑


File: wp-includes/cron.php. View all references

function _set_cron_array( $cron, $wp_error = false ) {
	if ( ! is_array( $cron ) ) {
		$cron = array();

	$cron['version'] = 2;
	$result          = update_option( 'cron', $cron );

	if ( $wp_error && ! $result ) {
		return new WP_Error(
			__( 'The cron event list could not be saved.' )

	return $result;

Top ↑


Version Description
5.7.0 The $wp_error parameter was added.
5.1.0 Return value modified to outcome of update_option() .
2.1.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.