A WordPress-centric search engine for devs and theme authors

registration_errors › WordPress Filter Hooks

apply_filters( 'registration_errors', $errors, $sanitized_user_login, $user_email )
Parameters: (3)
  • (WP_Error) $errors A WP_Error object containing any errors encountered during registration.
    Required: Yes
  • (string) $sanitized_user_login User's username after it has been sanitized.
    Required: Yes
  • (string) $user_email User's email.
    Required: Yes
Defined at:

Filters the errors encountered when a new user is being registered.

The filtered WP_Error object may, for example, contain errors for an invalid or existing username or email address. A WP_Error object should always be returned, but may or may not contain errors.

If any errors are present in $errors, this will abort the user's registration.


$errors = apply_filters( 'registration_errors', $errors, $sanitized_user_login, $user_email );