apply_filters( 'insert_custom_user_meta', array $custom_meta, WP_User $user, bool $update, array $userdata )
- Since
- 5.9.0
Filters a user's custom meta values and keys immediately after the user is created or updated and before any user meta is inserted or updated.
Description
For non-custom meta fields, see the 'insert_user_meta' filter.
Compatibility
- WordPress
- since 5.9.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$custom_metaarray- Array of custom user meta values keyed by meta key.
$userWP_User- User object.
$updatebool- Whether the user is being updated rather than created.
$userdataarray- The raw array of data passed to wp_insert_user().
Where this hook fires · 1
wp-includes/user.php:2637wp_insert_user()
Changelog
Introduced in 5.9.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.