apply_filters( 'insert_user_meta', array $meta, WP_User $user, bool $update )

Filters a user’s meta values and keys immediately after the user is created or updated and before any user meta is inserted or updated.

Description Description

Does not include contact methods. These are added using wp_get_user_contact_methods( $user ).

Parameters Parameters


(array) Default meta values and keys for the user.

  • 'nickname'
    (string) The user's nickname. Default is the user's username.
  • 'first_name'
    (string) The user's first name.
  • 'last_name'
    (string) The user's last name.
  • 'description'
    (string) The user's description.
  • 'rich_editing'
    (bool) Whether to enable the rich-editor for the user. False if not empty.
  • 'syntax_highlighting'
    (bool) Whether to enable the rich code editor for the user. False if not empty.
  • 'comment_shortcuts'
    (bool) Whether to enable keyboard shortcuts for the user. Default false.
  • 'admin_color'
    (string) The color scheme for a user's admin screen. Default 'fresh'.
  • 'use_ssl'
    (int|bool) Whether to force SSL on the user's admin area. 0|false if SSL is not forced.
  • 'show_admin_bar_front'
    (bool) Whether to show the admin bar on the front end for the user. Default true.
  • 'locale'
    (string) User's locale. Default empty.


(WP_User) User object.


(bool) Whether the user is being updated rather than created.

Top ↑

Source Source

File: wp-includes/user.php

View on Trac

Top ↑

Changelog Changelog

Version Description
4.4.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.