remove_theme_mod() WP 1.0

Remove theme modification name from current theme list.

If removing the name also removes all elements, then the entire option will be removed.

Works based on: get_theme_mods(), update_option(), remove_theme_mods()

✈ 1 time = 0.001562s = very slow | 50000 times = 2.79s = fast

No Hooks.

Return

Null. Nothing.

Usage

remove_theme_mod( $name );

$name(string) (required): Theme modification name.

Changelog

Since 2.1.0

Introduced.

Code of remove theme mod: `wp-includes/theme.php` ^{WP 5.2.2}

<?php
function remove_theme_mod( $name ) {
	$mods = get_theme_mods();

	if ( ! isset( $mods[ $name ] ) ) {
		return;
	}

	unset( $mods[ $name ] );

	if ( empty( $mods ) ) {
		remove_theme_mods();
		return;
	}
	$theme = get_option( 'stylesheet' );
	update_option( "theme_mods_$theme", $mods );
}