# update_user_meta()

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

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

## Сигнатура

```php
update_user_meta( int $user_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|bool
```

## Описание

Используйте параметр $prev_value, чтобы различать поля метаданных с одинаковыми ключом и ID пользователя.
Если поле метаданных для пользователя не существует, оно будет добавлено.
По историческим причинам и ключ, и значение метаданных на входе должны быть экранированы обратными слешами.

## Параметры

- `$user_id` `int` — обязательный. ID пользователя.
- `$meta_key` `string` — обязательный. Ключ метаданных.
- `$meta_value` `mixed` — обязательный. Значение метаданных. Должно быть сериализуемым, если не является скалярным значением.
- `$prev_value` `mixed` — необязательный, по умолчанию `''`. Предыдущее значение для проверки перед обновлением.
  
  Если указано, обновляются только существующие записи метаданных с этим значением. В противном случае обновляются все записи.

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

`int|bool`

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

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

```php
function update_user_meta( $user_id, $meta_key, $meta_value, $prev_value = '' ) {
	return update_metadata( 'user', $user_id, $meta_key, $meta_value, $prev_value );
}
```

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

- 3.0.0 — Introduced.

## Связанные

Использует: [`update_metadata`](https://chugunov.pro/api-wordpress/functions/update_metadata/).
Используется в: `WP_Application_Passwords::set_user_application_passwords`, [`wp_initialize_site`](https://chugunov.pro/api-wordpress/functions/wp_initialize_site/), [`wp_localize_community_events`](https://chugunov.pro/api-wordpress/functions/wp_localize_community_events/), [`wp_ajax_get_community_events`](https://chugunov.pro/api-wordpress/functions/wp_ajax_get_community_events/), `WP_Screen::render_meta_boxes_preferences`, [`wp_ajax_save_wporg_username`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_wporg_username/), `WP_User_Meta_Session_Tokens::update_sessions`, [`choose_primary_blog`](https://chugunov.pro/api-wordpress/functions/choose_primary_blog/), [`send_confirmation_on_profile_email`](https://chugunov.pro/api-wordpress/functions/send_confirmation_on_profile_email/), [`set_screen_options`](https://chugunov.pro/api-wordpress/functions/set_screen_options/), [`populate_network`](https://chugunov.pro/api-wordpress/functions/populate_network/), [`wp_install`](https://chugunov.pro/api-wordpress/functions/wp_install/), [`wp_install_defaults`](https://chugunov.pro/api-wordpress/functions/wp_install_defaults/), [`default_password_nag_handler`](https://chugunov.pro/api-wordpress/functions/default_password_nag_handler/), [`default_password_nag_edit_user`](https://chugunov.pro/api-wordpress/functions/default_password_nag_edit_user/), `WP_Plugin_Install_List_Table::prepare_items`, [`wp_ajax_save_user_color_scheme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_user_color_scheme/), [`wp_ajax_dismiss_wp_pointer`](https://chugunov.pro/api-wordpress/functions/wp_ajax_dismiss_wp_pointer/), [`wp_ajax_closed_postboxes`](https://chugunov.pro/api-wordpress/functions/wp_ajax_closed_postboxes/), [`wp_ajax_hidden_columns`](https://chugunov.pro/api-wordpress/functions/wp_ajax_hidden_columns/), [`wp_ajax_update_welcome_panel`](https://chugunov.pro/api-wordpress/functions/wp_ajax_update_welcome_panel/), [`wp_ajax_meta_box_order`](https://chugunov.pro/api-wordpress/functions/wp_ajax_meta_box_order/), [`wp_nav_menu_setup`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu_setup/), [`wp_initial_nav_menu_meta_boxes`](https://chugunov.pro/api-wordpress/functions/wp_initial_nav_menu_meta_boxes/), `WP_User::update_user_level_from_caps`, `WP_User::add_cap`, `WP_User::remove_cap`, `WP_User::add_role`, `WP_User::remove_role`, `WP_User::set_role`, [`reset_password`](https://chugunov.pro/api-wordpress/functions/reset_password/), [`register_new_user`](https://chugunov.pro/api-wordpress/functions/register_new_user/), [`wp_insert_user`](https://chugunov.pro/api-wordpress/functions/wp_insert_user/), [`update_user_option`](https://chugunov.pro/api-wordpress/functions/update_user_option/), [`add_new_user_to_blog`](https://chugunov.pro/api-wordpress/functions/add_new_user_to_blog/), [`get_active_blog_for_user`](https://chugunov.pro/api-wordpress/functions/get_active_blog_for_user/), [`add_user_to_blog`](https://chugunov.pro/api-wordpress/functions/add_user_to_blog/), [`remove_user_from_blog`](https://chugunov.pro/api-wordpress/functions/remove_user_from_blog/).

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