Title: core_auto_updates_settings
Published: December 9, 2020
Last modified: February 24, 2026

---

# core_auto_updates_settings()

## In this article

 * [Source](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#wp--skip-link--target)

Display WordPress auto-updates settings.

## 󠀁[Source](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#source)󠁿

    ```php
    function core_auto_updates_settings() {
    	if ( isset( $_GET['core-major-auto-updates-saved'] ) ) {
    		if ( 'enabled' === $_GET['core-major-auto-updates-saved'] ) {
    			$notice_text = __( 'Automatic updates for all WordPress versions have been enabled. Thank you!' );
    			wp_admin_notice(
    				$notice_text,
    				array(
    					'type'        => 'success',
    					'dismissible' => true,
    				)
    			);
    		} elseif ( 'disabled' === $_GET['core-major-auto-updates-saved'] ) {
    			$notice_text = __( 'WordPress will only receive automatic security and maintenance releases from now on.' );
    			wp_admin_notice(
    				$notice_text,
    				array(
    					'type'        => 'success',
    					'dismissible' => true,
    				)
    			);
    		}
    	}

    	require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
    	$updater = new WP_Automatic_Updater();

    	// Defaults:
    	$upgrade_dev   = get_site_option( 'auto_update_core_dev', 'enabled' ) === 'enabled';
    	$upgrade_minor = get_site_option( 'auto_update_core_minor', 'enabled' ) === 'enabled';
    	$upgrade_major = get_site_option( 'auto_update_core_major', 'unset' ) === 'enabled';

    	$can_set_update_option = true;
    	// WP_AUTO_UPDATE_CORE = true (all), 'beta', 'rc', 'development', 'branch-development', 'minor', false.
    	if ( defined( 'WP_AUTO_UPDATE_CORE' ) ) {
    		if ( false === WP_AUTO_UPDATE_CORE ) {
    			// Defaults to turned off, unless a filter allows it.
    			$upgrade_dev   = false;
    			$upgrade_minor = false;
    			$upgrade_major = false;
    		} elseif ( true === WP_AUTO_UPDATE_CORE
    			|| in_array( WP_AUTO_UPDATE_CORE, array( 'beta', 'rc', 'development', 'branch-development' ), true )
    		) {
    			// ALL updates for core.
    			$upgrade_dev   = true;
    			$upgrade_minor = true;
    			$upgrade_major = true;
    		} elseif ( 'minor' === WP_AUTO_UPDATE_CORE ) {
    			// Only minor updates for core.
    			$upgrade_dev   = false;
    			$upgrade_minor = true;
    			$upgrade_major = false;
    		}

    		// The UI is overridden by the `WP_AUTO_UPDATE_CORE` constant.
    		$can_set_update_option = false;
    	}

    	if ( $updater->is_disabled() ) {
    		$upgrade_dev   = false;
    		$upgrade_minor = false;
    		$upgrade_major = false;

    		/*
    		 * The UI is overridden by the `AUTOMATIC_UPDATER_DISABLED` constant
    		 * or the `automatic_updater_disabled` filter,
    		 * or by `wp_is_file_mod_allowed( 'automatic_updater' )`.
    		 * See `WP_Automatic_Updater::is_disabled()`.
    		 */
    		$can_set_update_option = false;
    	}

    	// Is the UI overridden by a plugin using the `allow_major_auto_core_updates` filter?
    	if ( has_filter( 'allow_major_auto_core_updates' ) ) {
    		$can_set_update_option = false;
    	}

    	/** This filter is documented in wp-admin/includes/class-core-upgrader.php */
    	$upgrade_dev = apply_filters( 'allow_dev_auto_core_updates', $upgrade_dev );
    	/** This filter is documented in wp-admin/includes/class-core-upgrader.php */
    	$upgrade_minor = apply_filters( 'allow_minor_auto_core_updates', $upgrade_minor );
    	/** This filter is documented in wp-admin/includes/class-core-upgrader.php */
    	$upgrade_major = apply_filters( 'allow_major_auto_core_updates', $upgrade_major );

    	$auto_update_settings = array(
    		'dev'   => $upgrade_dev,
    		'minor' => $upgrade_minor,
    		'major' => $upgrade_major,
    	);

    	if ( $upgrade_major ) {
    		$wp_version = wp_get_wp_version();
    		$updates    = get_core_updates();

    		if ( isset( $updates[0]->version ) && version_compare( $updates[0]->version, $wp_version, '>' ) ) {
    			echo '<p>' . wp_get_auto_update_message() . '</p>';
    		}
    	}

    	$action_url = self_admin_url( 'update-core.php?action=core-major-auto-updates-settings' );
    	?>

    	<p class="auto-update-status">
    		<?php

    		if ( $updater->is_vcs_checkout( ABSPATH ) ) {
    			_e( 'This site appears to be under version control. Automatic updates are disabled.' );
    		} elseif ( $upgrade_major ) {
    			_e( 'This site is automatically kept up to date with each new version of WordPress.' );

    			if ( $can_set_update_option ) {
    				echo '<br />';
    				printf(
    					'<a href="%s" class="core-auto-update-settings-link core-auto-update-settings-link-disable">%s</a>',
    					wp_nonce_url( add_query_arg( 'value', 'disable', $action_url ), 'core-major-auto-updates-nonce' ),
    					__( 'Switch to automatic updates for maintenance and security releases only.' )
    				);
    			}
    		} elseif ( $upgrade_minor ) {
    			_e( 'This site is automatically kept up to date with maintenance and security releases of WordPress only.' );

    			if ( $can_set_update_option ) {
    				echo '<br />';
    				printf(
    					'<a href="%s" class="core-auto-update-settings-link core-auto-update-settings-link-enable">%s</a>',
    					wp_nonce_url( add_query_arg( 'value', 'enable', $action_url ), 'core-major-auto-updates-nonce' ),
    					__( 'Enable automatic updates for all new versions of WordPress.' )
    				);
    			}
    		} else {
    			_e( 'This site will not receive automatic updates for new versions of WordPress.' );
    		}
    		?>
    	</p>

    	<?php
    	/**
    	 * Fires after the major core auto-update settings.
    	 *
    	 * @since 5.6.0
    	 *
    	 * @param array $auto_update_settings {
    	 *     Array of core auto-update settings.
    	 *
    	 *     @type bool $dev   Whether to enable automatic updates for development versions.
    	 *     @type bool $minor Whether to enable minor automatic core updates.
    	 *     @type bool $major Whether to enable major automatic core updates.
    	 * }
    	 */
    	do_action( 'after_core_auto_updates_settings', $auto_update_settings );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/update-core.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/update-core.php#L306)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/update-core.php#L306-L455)

## 󠀁[Hooks](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#hooks)󠁿

 [do_action( ‘after_core_auto_updates_settings’, array $auto_update_settings )](https://developer.wordpress.org/reference/hooks/after_core_auto_updates_settings/)

Fires after the major core auto-update settings.

 [apply_filters( ‘allow_dev_auto_core_updates’, bool $upgrade_dev )](https://developer.wordpress.org/reference/hooks/allow_dev_auto_core_updates/)

Filters whether to enable automatic core updates for development versions.

 [apply_filters( ‘allow_major_auto_core_updates’, bool $upgrade_major )](https://developer.wordpress.org/reference/hooks/allow_major_auto_core_updates/)

Filters whether to enable major automatic core updates.

 [apply_filters( ‘allow_minor_auto_core_updates’, bool $upgrade_minor )](https://developer.wordpress.org/reference/hooks/allow_minor_auto_core_updates/)

Filters whether to enable minor automatic core updates.

## 󠀁[Related](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#related)󠁿

| Uses | Description | 
| [wp_get_wp_version()](https://developer.wordpress.org/reference/functions/wp_get_wp_version/)`wp-includes/functions.php` |

Returns the current WordPress version.

  | 
| [wp_admin_notice()](https://developer.wordpress.org/reference/functions/wp_admin_notice/)`wp-includes/functions.php` |

Outputs an admin notice.

  | 
| [wp_get_auto_update_message()](https://developer.wordpress.org/reference/functions/wp_get_auto_update_message/)`wp-admin/includes/update.php` |

Determines the appropriate auto-update message to be displayed.

  | 
| [get_core_updates()](https://developer.wordpress.org/reference/functions/get_core_updates/)`wp-admin/includes/update.php` |

Gets available core updates.

  | 
| [self_admin_url()](https://developer.wordpress.org/reference/functions/self_admin_url/)`wp-includes/link-template.php` |

Retrieves the URL to the admin area for either the current site or the network depending on context.

  | 
| [has_filter()](https://developer.wordpress.org/reference/functions/has_filter/)`wp-includes/plugin.php` |

Checks if any filter has been registered for a hook.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [_e()](https://developer.wordpress.org/reference/functions/_e/)`wp-includes/l10n.php` |

Displays translated text.

  | 
| [wp_nonce_url()](https://developer.wordpress.org/reference/functions/wp_nonce_url/)`wp-includes/functions.php` |

Retrieves URL with nonce added to URL query.

  | 
| [add_query_arg()](https://developer.wordpress.org/reference/functions/add_query_arg/)`wp-includes/functions.php` |

Retrieves a modified URL query string.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  | 
| [do_action()](https://developer.wordpress.org/reference/functions/do_action/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to an action hook.

  | 
| [get_site_option()](https://developer.wordpress.org/reference/functions/get_site_option/)`wp-includes/option.php` |

Retrieve an option value for the current network based on name of option.

  |

[Show 8 more](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/core_auto_updates_settings/?output_format=md#changelog)󠁿

| Version | Description | 
| [5.6.0](https://developer.wordpress.org/reference/since/5.6.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fcore_auto_updates_settings%2F)
before being able to contribute a note or feedback.