apply_filters( 'random_password', string $password, int $length, bool $special_chars, bool $extra_special_chars )

Filters the randomly-generated password.


$password string
The generated password.
$length int
The length of password to generate.
$special_chars bool
Whether to include standard special characters.
$extra_special_chars bool
Whether to include other special characters.

Top ↑


File: wp-includes/pluggable.php. View all references

return apply_filters( 'random_password', $password, $length, $special_chars, $extra_special_chars );

Top ↑


Version Description
5.3.0 Added the $length, $special_chars, and $extra_special_chars parameters.
3.0.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Steven Lin

    Example migrated from Codex:

    Form a new password by appending your own password string to the generated password.

    add_filter( 'random_password', 'my_random_password' );
    function my_random_password() {
        $characters ='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
        $length = 10;
        $password = '';
        for( $i = 0; $i < $length; $i++ ) {
            $password .= substr( $characters , wp_rand( 0, strlen( $characters ) - 1 ), 1 );
        return $password;

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