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

Permissions

The Permissions section exposes role membership and explicitly granted capabilities.

Roles

Roles determine the normal capability set for a user. Only roles returned by WordPress as editable in the current context are available.

Changing another user's role requires the relevant profile and promotion capabilities. On multisite, checks are performed in the context of each affected site.

Additional capabilities

The Additional Capabilities metabox shows capabilities stored directly for the account rather than inherited from a role. These values can be difficult to reason about and should be changed only when their source and effect are understood.

Removing a role

Where the interface allows an empty role, saving it removes the user's role for that site. On multisite this can remove site access without deleting the network user.

Super administrators

Super-administrator changes are multisite-only and are protected by WordPress's network permissions and confirmation behavior. Treat them as high-risk operations.

Troubleshooting access

If a role is missing, confirm that the current administrator can promote users on the target site and that the role exists in that site's role registry.

Clone this wiki locally