Summery Summery

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.

Syntax Syntax

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

Description Description

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

Parameters Parameters


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'
    (string) Whether to enable the rich-editor for the user. Default 'true'.
  • 'syntax_highlighting'
    (string) Whether to enable the rich code editor for the user. Default 'true'.
  • 'comment_shortcuts'
    (string) 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'
    (string) Whether to show the admin bar on the front end for the user. Default 'true'.
  • 'locale'
    (string) User's locale. Default empty.


User object.


Whether the user is being updated rather than created.

Source Source

File: wp-includes/user.php


Changelog Changelog

Version Description
4.4.0 Introduced.


Leave a Reply