W3cubDocs

/WordPress

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

Fires after the user’s role has changed.

Parameters

$user_idint
The user ID.
$rolestring
The new role.
$old_rolesstring[]
An array of the user’s previous roles.

Source

do_action( 'set_user_role', $this->ID, $role, $old_roles );

Changelog

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

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