Title: remove_theme_support
Published: April 25, 2014
Last modified: August 20, 2026

---

# remove_theme_support( string $feature ): bool

## In this article

 * [Description](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#see-also)
 * [Parameters](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#changelog)
 * [User Contributed Notes](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#user-contributed-notes)

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

Allows a theme to de-register its support of a certain feature

## 󠀁[Description](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#description)󠁿

Should be called in the theme’s functions.php file. Generally would be used for 
child themes to override support from the parent theme.

### 󠀁[See also](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#see-also)󠁿

 * [add_theme_support()](https://developer.wordpress.org/reference/functions/add_theme_support/)

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

 `$feature`stringrequired

The feature being removed. See [add_theme_support()](https://developer.wordpress.org/reference/functions/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'`
 * `'appearance-tools'`
 * `'automatic-feed-links'`
 * `'block-templates'`
 * `'block-template-parts'`
 * `'border'`
 * `'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'`
 * `'disable-custom-gradients'`
 * `'disable-layout-styles'`
 * `'editor-color-palette'`
 * `'editor-gradient-presets'`
 * `'editor-font-sizes'`
 * `'editor-spacing-sizes'`
 * `'editor-styles'`
 * `'featured-content'`
 * `'html5'`
 * `'link-color'`
 * `'menus'`
 * `'post-formats'`
 * `'post-thumbnails'`
 * `'responsive-embeds'`
 * `'starter-content'`
 * `'title-tag'`
 * `'widgets'`
 * `'widgets-block-editor'`
 * `'wp-block-styles'`

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

 bool Whether feature was removed.

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

    ```php
    function remove_theme_support( $feature ) {
    	// Do not remove internal registrations that are not used directly by themes.
    	if ( in_array( $feature, array( 'editor-style', 'widgets', 'menus' ), true ) ) {
    		return false;
    	}

    	return _remove_theme_support( $feature );
    }
    ```

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

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

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

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

  |

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

Remove image header support.

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

Remove custom background support.

  |

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

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

## 󠀁[User Contributed Notes](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#user-contributed-notes)󠁿

 1.  [Skip to note 2 content](https://developer.wordpress.org/reference/functions/remove_theme_support/?output_format=md#comment-content-1050)
 2.   [Codex](https://profiles.wordpress.org/codex/)  [  11 years ago  ](https://developer.wordpress.org/reference/functions/remove_theme_support/#comment-1050)
 3. [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fremove_theme_support%2F%23comment-1050)
    Vote results for this note: 1[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fremove_theme_support%2F%23comment-1050)
 4. **Removing a Feature In a Child Theme**
     In some cases, a Parent Theme may have
    activated a feature that you do not want to have available in your Child Theme.
    For instance, if you are using a parent theme that has activated Featured Images
    for all Pages and Posts, but you’d like to remove the functionality of having Featured
    Images for Pages in your Child Theme, you could do something like this:
 5.     ```php
        // in your Child Theme's functions.php    
    
        // Use the after_setup_theme hook with a priority of 11 to load after the
        // parent theme, which will fire on the default priority of 10
        add_action( 'after_setup_theme', 'remove_featured_images_from_child_theme', 11 ); 
    
        function remove_featured_images_from_child_theme() {
    
            // This will remove support for post thumbnails on ALL Post Types
            remove_theme_support( 'post-thumbnails' );
    
            // Add this line in to re-enable support for just Posts
            add_theme_support( 'post-thumbnails', array( 'post' ) );
        }
        ```
    
 6.  [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fremove_theme_support%2F%3Freplytocom%3D1050%23feedback-editor-1050)

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fremove_theme_support%2F)
before being able to contribute a note or feedback.