# wp_update_category()

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

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

## Сигнатура

```php
wp_update_category( array $catarr ): int|false
```

## Описание

Если нужно обновить только некоторые поля существующей категории, вызовите эту функцию, задав внутри $catarr только новые значения.

## Параметры

- `$catarr` `array` — обязательный. Значение 'cat_ID' является обязательным. Все остальные ключи необязательны.

## Возвращаемое значение

`int|false`

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

Файл: `wp-admin/includes/taxonomy.php:188`

```php
function wp_update_category( $catarr ) {
	$cat_id = (int) $catarr['cat_ID'];

	if ( isset( $catarr['category_parent'] ) && ( $cat_id === (int) $catarr['category_parent'] ) ) {
		return false;
	}

	// First, get all of the original fields.
	$category = get_term( $cat_id, 'category', ARRAY_A );
	_make_cat_compat( $category );

	// Escape data pulled from DB.
	$category = wp_slash( $category );

	// Merge old and new fields with new fields overwriting old ones.
	$catarr = array_merge( $category, $catarr );

	return wp_insert_category( $catarr );
}
```

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

- 2.0.0 — Introduced.

## Связанные

Использует: [`wp_insert_category`](https://chugunov.pro/api-wordpress/functions/wp_insert_category/), [`_make_cat_compat`](https://chugunov.pro/api-wordpress/functions/_make_cat_compat/), [`wp_slash`](https://chugunov.pro/api-wordpress/functions/wp_slash/), [`get_term`](https://chugunov.pro/api-wordpress/functions/get_term/).

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