apply_filters( 'wp_pre_insert_user_data', array $data, bool $update, int|null $id, array $userdata )

Filters user data before the record is created or updated.

Description Description

It only includes data in the users table, not any user metadata.

Top ↑

Parameters Parameters


(array) Values and keys for the user.

  • 'user_login'
    (string) The user's login. Only included if $update == false
  • 'user_pass'
    (string) The user's password.
  • 'user_email'
    (string) The user's email.
  • 'user_url'
    (string) The user's url.
  • 'user_nicename'
    (string) The user's nice name. Defaults to a URL-safe version of user's login
  • 'display_name'
    (string) The user's display name.
  • 'user_registered'
    (string) MySQL timestamp describing the moment when the user registered. Defaults to the current UTC timestamp.


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


(int|null) ID of the user to be updated, or NULL if the user is being created.


(array) The raw array of data passed to wp_insert_user().

Top ↑

Source Source

File: wp-includes/user.php

View on Trac

Top ↑

Changelog Changelog

Version Description
5.8.0 The $userdata parameter was added.
4.9.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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