# get_user_meta()

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

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

## Сигнатура

```php
get_user_meta( int $user_id, string $key = '', bool $single = false ): mixed
```

## Описание

Извлекает поле метаданных пользователя.

## Параметры

- `$user_id` `int` — обязательный. ID пользователя.
- `$key` `string` — необязательный, по умолчанию `''`. Ключ метаданных для получения. По умолчанию возвращает данные для всех ключей.
- `$single` `bool` — необязательный, по умолчанию `false`. Возвращать ли одно значение.
  
  Этот параметр не действует, если не указан $key.

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

`mixed` — $single $single $user_id $single $single значения false возвращаются как пустые строки (''), значения true возвращаются как '1', числа (как целые, так и с плавающей точкой) возвращаются как строки, массивы и объекты сохраняют свой исходный тип.

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

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

```php
function get_user_meta( $user_id, $key = '', $single = false ) {
	return get_metadata( 'user', $user_id, $key, $single );
}
```

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

- 3.0.0 — Introduced.

## Связанные

Использует: [`get_metadata`](https://chugunov.pro/api-wordpress/functions/get_metadata/).
Используется в: `WP_Application_Passwords::get_user_application_passwords`, [`wp_initialize_site`](https://chugunov.pro/api-wordpress/functions/wp_initialize_site/), [`wp_default_packages_inline_scripts`](https://chugunov.pro/api-wordpress/functions/wp_default_packages_inline_scripts/), [`the_block_editor_meta_boxes`](https://chugunov.pro/api-wordpress/functions/the_block_editor_meta_boxes/), [`register_and_do_post_meta_boxes`](https://chugunov.pro/api-wordpress/functions/register_and_do_post_meta_boxes/), [`wp_user_personal_data_exporter`](https://chugunov.pro/api-wordpress/functions/wp_user_personal_data_exporter/), `WP_User::get_caps_data`, `WP_Widget_Text::render_control_template_scripts`, `WP_Screen::render_meta_boxes_preferences`, `WP_User_Meta_Session_Tokens::get_sessions`, [`choose_primary_blog`](https://chugunov.pro/api-wordpress/functions/choose_primary_blog/), [`new_user_email_admin_notice`](https://chugunov.pro/api-wordpress/functions/new_user_email_admin_notice/), `WP_Internal_Pointers::enqueue_scripts`, [`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_User::__get`, [`wp_update_user`](https://chugunov.pro/api-wordpress/functions/wp_update_user/), [`get_blogs_of_user`](https://chugunov.pro/api-wordpress/functions/get_blogs_of_user/), [`is_user_member_of_blog`](https://chugunov.pro/api-wordpress/functions/is_user_member_of_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/get_user_meta/