Title: is_wp_version_compatible
Published: May 7, 2019
Last modified: February 24, 2026

---

# is_wp_version_compatible( string $required ): bool

## In this article

 * [Parameters](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#changelog)

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

Checks compatibility with the current WordPress version.

## 󠀁[Parameters](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#parameters)󠁿

 `$required`stringrequired

Minimum required WordPress version.

## 󠀁[Return](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?output_format=md#return)󠁿

 bool True if required version is compatible or empty, false if not.

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

    ```php
    function is_wp_version_compatible( $required ) {
    	if (
    		defined( 'WP_RUN_CORE_TESTS' )
    		&& WP_RUN_CORE_TESTS
    		&& isset( $GLOBALS['_wp_tests_wp_version'] )
    	) {
    		$wp_version = $GLOBALS['_wp_tests_wp_version'];
    	} else {
    		$wp_version = wp_get_wp_version();
    	}

    	// Strip off any -alpha, -RC, -beta, -src suffixes.
    	list( $version ) = explode( '-', $wp_version );

    	if ( is_string( $required ) ) {
    		$trimmed = trim( $required );

    		if ( substr_count( $trimmed, '.' ) > 1 && str_ends_with( $trimmed, '.0' ) ) {
    			$required = substr( $trimmed, 0, -2 );
    		}
    	}

    	return empty( $required ) || version_compare( $version, $required, '>=' );
    }
    ```

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

## 󠀁[Related](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/?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.

  |

| Used by | Description | 
| [validate_theme_requirements()](https://developer.wordpress.org/reference/functions/validate_theme_requirements/)`wp-includes/theme.php` |

Validates the theme requirements for WordPress version and PHP version.

  | 
| [Plugin_Installer_Skin::do_overwrite()](https://developer.wordpress.org/reference/classes/plugin_installer_skin/do_overwrite/)`wp-admin/includes/class-plugin-installer-skin.php` |

Checks if the plugin can be overwritten and outputs the HTML for overwriting a plugin on upload.

  | 
| [Theme_Installer_Skin::do_overwrite()](https://developer.wordpress.org/reference/classes/theme_installer_skin/do_overwrite/)`wp-admin/includes/class-theme-installer-skin.php` |

Checks if the theme can be overwritten and outputs the HTML for overwriting a theme on upload.

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

Validates the plugin requirements for WordPress version and PHP version.

  | 
| [WP_Customize_Manager::handle_load_themes_request()](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_load_themes_request/)`wp-includes/class-wp-customize-manager.php` |

Loads themes into the theme browsing/installation UI.

  | 
| [Plugin_Upgrader::bulk_upgrade()](https://developer.wordpress.org/reference/classes/plugin_upgrader/bulk_upgrade/)`wp-admin/includes/class-plugin-upgrader.php` |

Upgrades several plugins at once.

  | 
| [Plugin_Upgrader::check_package()](https://developer.wordpress.org/reference/classes/plugin_upgrader/check_package/)`wp-admin/includes/class-plugin-upgrader.php` |

Checks that the source package contains a valid plugin.

  | 
| [Theme_Upgrader::bulk_upgrade()](https://developer.wordpress.org/reference/classes/theme_upgrader/bulk_upgrade/)`wp-admin/includes/class-theme-upgrader.php` |

Upgrades several themes at once.

  | 
| [Theme_Upgrader::check_package()](https://developer.wordpress.org/reference/classes/theme_upgrader/check_package/)`wp-admin/includes/class-theme-upgrader.php` |

Checks that the package source contains a valid theme.

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

Prepares themes for JavaScript.

  | 
| [WP_Plugins_List_Table::single_row()](https://developer.wordpress.org/reference/classes/wp_plugins_list_table/single_row/)`wp-admin/includes/class-wp-plugins-list-table.php` |  | 
| [wp_theme_update_row()](https://developer.wordpress.org/reference/functions/wp_theme_update_row/)`wp-admin/includes/update.php` |

Displays update information for a theme.

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

Displays plugin information in dialog box form.

  | 
| [WP_Plugin_Install_List_Table::display_rows()](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/)`wp-admin/includes/class-wp-plugin-install-list-table.php` |

Generates the list table rows.

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

Handles getting themes from [themes_api()](https://developer.wordpress.org/reference/functions/themes_api/) via AJAX.

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

Display the upgrade themes form.

  |

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

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

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

## User Contributed Notes

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