do_action( 'switch_theme', string $new_name, WP_Theme $new_theme, WP_Theme $old_theme )

Fires after the theme is switched.

Parameters
More Information
Source
Related
- Used By
Changelog
User Contributed Notes

Parameters

$new_name string: Name of the new theme.
$new_theme WP_Theme: WP_Theme instance of the new theme.
$old_theme WP_Theme: WP_Theme instance of the old theme.

switch_theme is triggered when the blog’s theme is changed. Specifically, it fires after the theme has been switched but before the next request. Theme developers should use this hook to do things when their theme is deactivated.

Theme functions attached to this hook are only triggered in the theme being deactivated. To do things when your theme is activated, use after_switch_theme.

Functions attached to this action hook receive one parameter: a string with the name of the new theme being activated.

Top ↑

Source

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

do_action( 'switch_theme', $new_name, $new_theme, $old_theme );

View on Trac View on GitHub

Top ↑

Used By

Used By
Used By	Description
switch_theme() wp-includes/theme.php	Switches the theme.

Top ↑

Changelog

Changelog
Version	Description
4.5.0	Introduced the `$old_theme` parameter.
1.5.0	Introduced.

Top ↑

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by sarahcoding — 5 years ago
This hook is useful while deactivating a theme.

For example:
```
function deactivate_my_theme( $new_theme ) {
	flush_rewrite_rules(false);
}
add_action( 'switch_theme', 'deactivate_my_theme' );
```
Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Collins Mbaka — 2 years ago
Delete a theme’s options after deactivation
```
add_action('switch_theme', 'mytheme_setup_options');

function mytheme_setup_options () {
  delete_option('mytheme_enable_features');
  delete_option('mytheme_enable_catalog');
}
```
Log in to add feedback

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

Developer Resources

do_action( 'switch_theme', string $new_name, WP_Theme $new_theme, WP_Theme $old_theme )

Contents

Parameters

More Information

Source

Changelog

User Contributed Notes