Function and usage of get_users_of_blog() in wordpress


Answers ( 1 )


    The get_users_of_blog() function in WordPress is designed for use in multisite setups but can also be used outside of them. It retrieves a list of users associated with a specific site within a WordPress multisite network.

    Function Signature:

    get_users_of_blog( int $id = '' ): array


    • $id (int, optional): This parameter specifies the ID of the site from which you want to retrieve users. If not provided, the function uses the current site by default.

    Return Value:

    • The function returns an array containing a list of users that are part of the site specified by the site ID.


    Basic Usage:

    If you want to get users of the current site in a multisite setup, you can use the function without passing any parameters:

    $users = get_users_of_blog();
    // Do something with the $users array

    Specifying a Site ID:

    To get users from a specific site within your multisite network, provide the site ID as the parameter:

    $site_id = 2; // Assuming you want to get users from the site with ID 2
    $users = get_users_of_blog( $site_id );
    // Do something with the $users array


    $site_id = 3; // Example site ID
    $users = get_users_of_blog( $site_id );
    foreach ( $users as $user ) {
        echo 'Username: ' . $user->user_login . ' - Email: ' . $user->user_email . "<br>";

    This example retrieves the users of the site with ID 3 and iterates over the array to display each user's username and email.


    • This function is particularly useful in multisite environments where you need to manage or retrieve user information based on specific sites within the network.
    • It is a wrapper for the get_users() function, which is more commonly used and offers more flexibility.
    • Always ensure that the site ID is valid and exists within your network to avoid unexpected results.

    Remember that the availability and behavior of this function might change in future WordPress updates, so it's always a good idea to refer to the official WordPress documentation for the most current information.

Leave an answer