# remove_theme_mod()

URL: https://chugunov.pro/api-wordpress/functions/remove_theme_mod/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.1.0.

## Сигнатура

```php
remove_theme_mod( string $name )
```

## Описание

Если при удалении имени также удаляются все элементы, то будет удалена вся опция целиком.

## Параметры

- `$name` `string` — обязательный. Имя модификации темы.

## Исходный код

Файл: `wp-includes/theme.php:1138`

```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 );
}
```

## История изменений

- 2.1.0 — Introduced.

## Связанные

Использует: [`remove_theme_mods`](https://chugunov.pro/api-wordpress/functions/remove_theme_mods/), [`get_theme_mods`](https://chugunov.pro/api-wordpress/functions/get_theme_mods/), [`update_option`](https://chugunov.pro/api-wordpress/functions/update_option/), [`get_option`](https://chugunov.pro/api-wordpress/functions/get_option/).
Используется в: `Custom_Image_Header::set_header_image`, `Custom_Background::take_action`, [`_delete_attachment_theme_mod`](https://chugunov.pro/api-wordpress/functions/_delete_attachment_theme_mod/), [`switch_theme`](https://chugunov.pro/api-wordpress/functions/switch_theme/), `WP_Customize_Background_Image_Setting::update`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/remove_theme_mod/