BugWP logo BugWP
Back to Community
Home / Community / Core → Networking wordpress

Troubleshooting Common WordPress Multisite User Role and Capability Issues

20 threads Sep 16, 2025 Core → Networking wordpress

Content

WordPress Multisite is a powerful platform for managing multiple sites from a single installation. However, its complex user role and capability system can often lead to confusing issues for site administrators and editors. Based on common community reports, this guide explains the most frequent problems and provides clear solutions.

Common Multisite User Role Problems

Many Multisite users encounter similar issues where certain functionality works for Super Admins but not for other user roles. These problems typically stem from how WordPress handles capabilities differently in a Multisite environment compared to single-site installations.

1. Inability to Embed Content or Use Custom HTML

Problem: Editors and Authors cannot embed iframes from YouTube, Facebook, or other services, and their custom HTML gets stripped out when saving content.

Why it happens: In Multisite, the unfiltered_html capability is typically reserved only for Super Admins as a security measure. This prevents regular administrators and editors from adding potentially unsafe code.

Solution: You can grant this capability to other roles using code in your theme's functions.php file:

function add_unfiltered_html_capability($caps, $cap, $user_id) {
    if ('unfiltered_html' === $cap && user_can($user_id, 'administrator')) {
        $caps = array('unfiltered_html');
    }
    return $caps;
}
add_filter('map_meta_cap', 'add_unfiltered_html_capability', 1, 3);

Security Note: Be aware that allowing unfiltered HTML does present security risks. Only implement this solution if you trust your users with the ability to add arbitrary code.

2. Blocks Breaking After Non-Super Admin Edits

Problem: Complex blocks (like Google Maps or custom icon blocks) stop working properly after being edited and saved by non-Super Admin users.

Why it happens: This often relates to the same capability restrictions mentioned above. When users without proper capabilities save content, WordPress may strip out necessary code or attributes from blocks.

Solution: Ensure users have appropriate capabilities for the content they're editing. You may need to use a plugin like Members or User Role Editor to carefully adjust capabilities for specific roles.

3. Cannot See or Edit Other Users' Content

Problem: Editors cannot see pages or posts created by other users, even though they have the "edit_others_posts" capability.

Why it happens: This could be due to plugin conflicts or custom code that's interfering with normal WordPress capability checks.

Solution:

  1. Deactivate all plugins temporarily to check for conflicts
  2. Ensure the user role truly has the "edit_others_posts" capability
  3. Check if any custom code in your theme might be filtering capabilities
  4. Verify that users are properly assigned to the specific site in your Multisite network

4. Cannot Replace Files in File Blocks

Problem: Editors can upload files but cannot use the "Replace" button in File blocks unless they're Administrators.

Why it happens: The capability required for replacing files might differ from uploading them, and this may not be properly assigned in Multisite environments.

Solution: Investigate which specific capability controls file replacement (possibly edit_files or similar) and ensure it's granted to the appropriate roles using a role management plugin.

Best Practices for Managing Multisite Capabilities

  • Always test changes in a development environment before applying them to your live network
  • Use role management plugins rather than directly modifying database values
  • Grant minimal necessary capabilities - only provide the exact permissions users need to perform their tasks
  • Document all custom capability changes made to your network for future reference
  • Regularly audit user roles to ensure they still have appropriate permissions

If you continue to experience issues after trying these solutions, the WordPress community recommends checking the official WordPress support forums or GitHub repositories for more specific guidance related to your particular setup.

Related Support Threads Support