Skip to content
John James Jacoby edited this page Sep 16, 2026 · 1 revision

Multisite

WP User Profiles supports site administration, Network Admin, and the User Dashboard.

Sites section

On multisite, the Sites section can show:

  • the user's primary site;
  • site memberships;
  • roles for each site; and
  • actions available for those memberships.

Site context

Roles are site-specific. The plugin switches WordPress context while validating and applying role changes, then restores the original site context. Permissions are checked for each affected site.

Role discovery

Large networks may use local or remote strategies to discover role information. The strategy is filterable through wp_user_profiles_get_common_user_roles_strategy.

Related filters include:

  • pre_wp_user_profiles_common_user_roles
  • wp_user_profiles_filter_sites_table_query_args
  • wp_common_user_roles_cache_ttl
  • wp_user_roles_main_sites

Primary site

Changing the primary site affects links and default context associated with the user. The selected site must be one the user can access.

Network safety

Test role and membership automation on a staging network. A valid role name on one site may not exist on another, and custom role plugins may register different capabilities by site.

Clone this wiki locally