do_action( 'set_user_role', int $user_id, string $role, string[] $old_roles )

Fires after the user’s role has changed.

Parameters

$user_id

(int) The user ID.

$role

(string) The new role.

$old_roles

(string[]) An array of the user's previous roles.

Source

File: wp-includes/class-wp-user.php

View on Trac

Used By

Used By Description
wp-includes/class-wp-user.php: WP_User::set_role()

Set the role of the user.

Changelog

Version Description
3.6.0 Added $old_roles to include an array of the user's previous roles.
2.9.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/set_user_role