# update_user_option()

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

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

## Сигнатура

```php
update_user_option( int $user_id, string $option_name, mixed $newvalue, bool $is_global = false ): int|bool
```

## Описание

Пользовательские опции работают так же, как метаданные пользователя, за исключением того, что они поддерживают глобальные опции блога. Если параметр 'is_global' равен false, как по умолчанию, к имени опции добавляется префикс таблиц WordPress.
Удаляет пользовательскую опцию, если $newvalue пусто.

## Параметры

- `$user_id` `int` — обязательный. ID пользователя.
- `$option_name` `string` — обязательный. Имя пользовательской опции.
- `$newvalue` `mixed` — обязательный. Значение пользовательской опции.
- `$is_global` `bool` — необязательный, по умолчанию `false`. Является ли имя опции глобальным или относящимся к конкретному блогу.
  
  Значение по умолчанию false (относится к конкретному блогу).

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

`int|bool`

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

Файл: `wp-includes/user.php:813`

```php
function update_user_option( $user_id, $option_name, $newvalue, $is_global = false ) {
	global $wpdb;

	if ( ! $is_global ) {
		$option_name = $wpdb->get_blog_prefix() . $option_name;
	}

	return update_user_meta( $user_id, $option_name, $newvalue );
}
```

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

- 2.0.0 — Introduced.

## Связанные

Использует: [`update_user_meta`](https://chugunov.pro/api-wordpress/functions/update_user_meta/), `wpdb::get_blog_prefix`.
Используется в: [`wp_dashboard_quick_press`](https://chugunov.pro/api-wordpress/functions/wp_dashboard_quick_press/), [`wp_user_settings`](https://chugunov.pro/api-wordpress/functions/wp_user_settings/), [`wp_set_all_user_settings`](https://chugunov.pro/api-wordpress/functions/wp_set_all_user_settings/), [`delete_all_user_settings`](https://chugunov.pro/api-wordpress/functions/delete_all_user_settings/).

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