# insert_custom_user_meta

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

Тип: хук-фильтр.
Появился в версии: 5.9.0.

## Сигнатура

```php
apply_filters( 'insert_custom_user_meta', array $custom_meta, WP_User $user, bool $update, array $userdata )
```

## Описание

Для непроизвольных полей метаданных смотрите фильтр 'insert_user_meta'.

## Параметры

- `$custom_meta` `array` — обязательный. Массив произвольных значений метаданных пользователя с ключами по ключу метаданных.
- `$user` `WP_User` — обязательный. Объект пользователя.
- `$update` `bool` — обязательный. Обновляется ли пользователь, а не создаётся.
- `$userdata` `array` — обязательный. Необработанный массив данных, переданных в wp_insert_user() .

## Фильтруемое значение

Массив произвольных значений метаданных пользователя с ключами по ключу метаданных.

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

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

```php
$custom_meta = apply_filters( 'insert_custom_user_meta', $custom_meta, $user, $update, $userdata );
```

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

- 5.9.0 — Introduced.

## Связанные

Используется в: [`wp_insert_user`](https://chugunov.pro/api-wordpress/functions/wp_insert_user/).

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