Do not use. Removes theme support internally without knowledge of those not used by themes directly.

$feature string Required

The feature being removed. See add_theme_support() for the list of possible values.

More Arguments from add_theme_support( ... $feature )

The feature being added. Likely core values include:

• 'admin-bar'
• 'align-wide'
• 'automatic-feed-links'
• 'core-block-patterns'
• 'custom-background'
• 'custom-header'
• 'custom-line-height'
• 'custom-logo'
• 'customize-selective-refresh-widgets'
• 'custom-spacing'
• 'custom-units'
• 'dark-editor-style'
• 'disable-custom-colors'
• 'disable-custom-font-sizes'
• 'editor-color-palette'
• 'editor-gradient-presets'
• 'editor-font-sizes'
• 'editor-styles'
• 'featured-content'
• 'html5'
• 'menus'
• 'post-formats'
• 'post-thumbnails'
• 'responsive-embeds'
• 'starter-content'
• 'title-tag'
• 'wp-block-styles'
• 'widgets'
• 'widgets-block-editor'

bool True if support was removed, false if the feature was not registered.

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

function _remove_theme_support( $feature ) {
	global $_wp_theme_features;

	switch ( $feature ) {
		case 'custom-header-uploads':
			if ( ! isset( $_wp_theme_features['custom-header'] ) ) {
				return false;
			}
			add_theme_support( 'custom-header', array( 'uploads' => false ) );
			return; // Do not continue - custom-header-uploads no longer exists.
	}

	if ( ! isset( $_wp_theme_features[ $feature ] ) ) {
		return false;
	}

	switch ( $feature ) {
		case 'custom-header':
			if ( ! did_action( 'wp_loaded' ) ) {
				break;
			}
			$support = get_theme_support( 'custom-header' );
			if ( isset( $support[0]['wp-head-callback'] ) ) {
				remove_action( 'wp_head', $support[0]['wp-head-callback'] );
			}
			if ( isset( $GLOBALS['custom_image_header'] ) ) {
				remove_action( 'admin_menu', array( $GLOBALS['custom_image_header'], 'init' ) );
				unset( $GLOBALS['custom_image_header'] );
			}
			break;

		case 'custom-background':
			if ( ! did_action( 'wp_loaded' ) ) {
				break;
			}
			$support = get_theme_support( 'custom-background' );
			if ( isset( $support[0]['wp-head-callback'] ) ) {
				remove_action( 'wp_head', $support[0]['wp-head-callback'] );
			}
			remove_action( 'admin_menu', array( $GLOBALS['custom_background'], 'init' ) );
			unset( $GLOBALS['custom_background'] );
			break;
	}

	unset( $_wp_theme_features[ $feature ] );

	return true;
}