{"id":325,"date":"2025-05-06T09:09:25","date_gmt":"2025-05-06T09:09:25","guid":{"rendered":"https:\/\/blog.hostinger.io\/support\/2025\/05\/06\/11204114-how-to-reset-wordpress-user-roles-and-capabilities\/"},"modified":"2026-05-08T12:59:28","modified_gmt":"2026-05-08T12:59:28","slug":"11204114-how-to-reset-wordpress-user-roles-and-capabilities","status":"publish","type":"post","link":"https:\/\/www.hostinger.com\/support\/11204114-how-to-reset-wordpress-user-roles-and-capabilities\/","title":{"rendered":"How to Reset WordPress User Roles and Capabilities"},"content":{"rendered":"

If your WordPress roles or user capabilities got deleted or damaged, you can restore the WordPress user roles and capabilities<\/b> using WP-CLI<\/b>.<\/p>

\n<\/p>

Step 1 – Connect via SSH<\/h2>

Connect to your account via SSH<\/a><\/b> and open the directory where you installed WordPress. For most domains, it will be the public_html<\/b> folder, so to reach the path, use the following command:<\/p>

\n<\/p>

cd ~\/domains\/domain.tld\/public_html<\/code><\/pre>
\n
Make sure to replace domain.tld<\/b> with your domain name.<\/p>\n<\/div>
Step 2 – Check existing user roles & capabilities<\/h2>
Checking roles<\/h3>
Before making any changes, we should first check the existing roles to see if any of them need to be reset. For that, we can use this command:<\/p>
wp role list<\/code><\/pre>
\"Hostinger<\/div>
WordPress has five pre-defined roles: Administrator, Editor, Author, Contributor, and Subscriber<\/b>. One additional Super Admin<\/b> role is available on WordPress multisite networks.<\/p>
\n
Your website’s plugins may create additional roles. For example, WooCommerce<\/b> users may find additional “Customer”<\/b> and “Shop Manager”<\/b> roles available on their website.<\/p>\n<\/div>
\n<\/p>
Checking capabilities<\/h3>
If all default user roles exist, we should verify whether their capabilities are properly assigned. To do that, we can use this command:<\/p>
wp cap list administrator<\/code><\/pre>
To check other roles, simply replace administrator<\/code> with the name of the role you want to check.<\/p>
\"Hostinger<\/div>
\n
If the output appears empty or is missing essential capabilities, your user roles may be damaged. See WordPress Roles and Capabilities documentation<\/a><\/b> for a complete list of default capabilities per role.<\/p>\n<\/div>
\n<\/p>
Step 3 – Resetting roles & capabilities to default settings<\/h2>
If any of the default roles or their capabilities are missing, we can use WP-CLI to reset them. To reset the administrator role and its capabilities, we can use this command:<\/p>
wp role reset administrator<\/code><\/pre>
To reset other roles (or their capabilities), simply replace administrator<\/code> with the name of the role you want to reset.<\/p>
\"Hostinger<\/div>
Alternatively, we can reset all roles and their capabilities<\/b> with a single command:<\/p>
wp role reset --all<\/code><\/pre>
\n
Warning:<\/b> Using wp role reset --all<\/code> will reset all<\/b> roles on your site, including custom roles created by plugins. This will remove custom capabilities and restore the roles to their default state. Please be sure to proceed with caution and make sure you have a backup<\/a><\/b>.<\/p>\n<\/div>
After resetting, confirm all needed roles exist using wp role list<\/code>. Then, check if the roles have restored capabilities correctly by re-running wp cap list administrator<\/code>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn to reset WordPress roles and capabilities with WP-CLI to fix issues with missing or damaged settings.<\/p>\n","protected":false},"author":581,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"include_on_kodee":true,"footnotes":""},"categories":[179],"tags":[],"class_list":["post-325","post","type-post","status-publish","format-standard","hentry","category-wordpress-management"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/support\/11204114-how-to-reset-wordpress-user-roles-and-capabilities\/","default":1}],"include_on_kodee":true,"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/325","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/users\/581"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/comments?post=325"}],"version-history":[{"count":1,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/325\/revisions"}],"predecessor-version":[{"id":1827,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/325\/revisions\/1827"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/media?parent=325"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/categories?post=325"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/tags?post=325"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}