add_existing_user_to_blog( array|false $details = false ): true|WP_Error|void

Adds a user to a blog based on details from maybe_add_existing_user_to_blog() .


User details. Must at least contain values for the keys listed below.
  • user_id int
    The ID of the user being added to the current blog.
  • role string
    The role to be assigned to the user.



true|WP_Error|void True on success or a WP_Error object if the user doesn’t exist or could not be added. Void if $details array was not provided.

More Information

This function is called by maybe_add_existing_user_to_blog() and should not be called directly. This page is for informational purposes only. Use add_user_to_blog().


function add_existing_user_to_blog( $details = false ) {
	if ( is_array( $details ) ) {
		$blog_id = get_current_blog_id();
		$result  = add_user_to_blog( $blog_id, $details['user_id'], $details['role'] );

		 * Fires immediately after an existing user is added to a site.
		 * @since MU (3.0.0)
		 * @param int           $user_id User ID.
		 * @param true|WP_Error $result  True on success or a WP_Error object if the user doesn't exist
		 *                               or could not be added.
		do_action( 'added_existing_user', $details['user_id'], $result );

		return $result;


do_action( ‘added_existing_user’, int $user_id, true|WP_Error $result )

Fires immediately after an existing user is added to a site.


MU (3.0.0)Introduced.

User Contributed Notes

  1. Skip to note 2 content

    function add_existing_user_to_blog($details = false) defines a function where add_existing_user_to_blog is the function name. Here in ($details = false) this part, $details is the parameter. Parameters are like placeholders for values that you can pass to the function when you call it. And ‘= false’, like the default value, means that if no values are provided for $details, then by default false will be worked.

    if (is_array($details)) this function first checks if the provided information is in the form of an array and the right format.

    $blog_id = get_current_blog_id() in which blog page or post you’re currently working on. Here $blog_id is the variable, and get_current_blog_id() is the function name.

    In the $result variable, the function named add_user_to_blog is called. Here, $blog_id represents the specific blog post to which a user is being added, with the user identified by $details[‘user_id’]. Additionally, in $details[‘role’], the permission level assigned to the user for the specific blog post is specified.

    do_action(‘added_existing_user’, $details[‘user_id’], $result) here action name ‘added_existing_user’. The parameter $details[‘user_id’] designates the user who was added. And the $result variable stores whether the user was successfully assigned or not.

    In short, this function makes sure that when you want to add an existing user to a particular blog, it verifies the information, adds the user, notifies the system to the addition, and then reports back to you on whether or not everything went according to plan. It functions similarly to a useful tool for WordPress site user management.

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