Setup & site building · Guide
How to Change User Roles in WordPress (Step by Step)

Short answer
Go to Users, then All Users, and click the person's name. Choose a new role from the Role dropdown on their profile and click Update User. To change several users at once, tick them in the list and use the Change role to dropdown.
Key takeaways
- Edit a user and pick a new role from the Role dropdown.
- Bulk change roles from the All Users list.
- You cannot change your own role; another admin must do it.
- Keep the default role for new users set to Subscriber.
- Give each person the lowest role they need.
How do you change a user role in WordPress?
Go to Users > All Users, click the user's name, pick a new role from the Role dropdown near the bottom of the profile screen and click Update User; the change takes effect straight away.
You need to be an Administrator, or have a role with the ability to promote users, to see that dropdown.
WordPress ships with five main roles on a single site: Administrator, Editor, Author, Contributor and Subscriber. Plugins like WooCommerce add more, such as Customer and Shop Manager.
The WordPress documentation on roles and capabilities lists what each built-in role can do.
What should you know before changing a role?
Check what the new role can do, give each person the lowest role that lets them do their job, and keep at least one other Administrator account so you never lock yourself out.
Roles are bundles of capabilities. Changing a role swaps the whole bundle, not just one permission.
A quick reference helps:
| Role | Can publish | Can edit others' posts | Can install plugins | Typical use |
|---|---|---|---|---|
| Administrator | Yes | Yes | Yes | Site owner |
| Editor | Yes | Yes | No | Content manager |
| Author | Own posts | No | No | Regular writer |
| Contributor | No | No | No | Guest writer |
| Subscriber | No | No | No | Members, commenters |
This follows the security idea of least privilege. NIST's glossary defines least privilege as giving users only the access they need.
For a plain-English tour of each role, read our explainer on WordPress user roles.
Step 1: How do you open the user's profile?
In the dashboard, click Users, then All Users, find the person by name, email or username, and click their username or the Edit link below it.
Use the search box at the top right if you have many users. You can also filter the list by role using the links above the table.
The list shows each user's current role in its own column, which helps you check before you edit.
Step 2: How do you choose the new role?
Scroll to the Role dropdown in the Name section of the profile, select the new role, then scroll down and click Update User to save.
The dropdown shows every role registered on the site, including roles added by plugins.
You will see a confirmation message at the top of the screen once the change is saved. The person gets the new access on their next page load.
WordPress does not send the user an email about a role change by default. Let them know yourself if their access has changed.
Step 3: How do you change roles for many users at once?
On the All Users screen, tick the checkboxes next to each user, open the Change role to dropdown above the list, pick the new role and click Change.
This is the fastest way to move a group, such as turning several contributors into authors.
The Users screen documentation explains the bulk options on this page.
Check your selection carefully before clicking Change. Bulk changes apply instantly and there is no undo button.
Why can't you change your own role?
WordPress hides the role dropdown on your own profile and blocks bulk changes to your own account, so an Administrator cannot accidentally remove their own admin access.
To change your own role, another Administrator must do it for you.
This is a useful safety net. It is also why every site should have a second Administrator account, stored safely, for emergencies.
How do you set the default role for new users?
Go to Settings > General, pick a role from the New User Default Role dropdown and save; WordPress gives that role to everyone who registers from then on.
Keep this set to Subscriber unless you have a clear reason. Setting it to Administrator or Editor would give strangers control of your site.
If Anyone can register is on, check this setting often. Our guide on how to stop fake user registrations in WordPress covers related protections.
Which role should you give common team members?
Match the role to the job: Contributor for guest writers, Author for regular writers, Editor for content managers, Shop Manager for store staff and Administrator only for people who run the whole site.
Many sites give Administrator access too freely. A developer who only needs to fix a template for a week can get temporary admin access, then be lowered or removed afterwards.
| Person | Suggested role | Why |
|---|---|---|
| Guest writer | Contributor | Writes drafts; an editor publishes |
| Staff writer | Author | Publishes own posts only |
| Content manager | Editor | Manages all posts and pages |
| Store assistant | Shop Manager | Handles orders without site settings |
| Developer or agency | Administrator, temporarily | Needs plugin and theme access |
| Customer or member | Subscriber or Customer | Account access only |
When someone leaves the team, do not just lower their role. Delete the account and attribute their content to another user when WordPress asks, or keep the account with the lowest role if you want their byline to stay.
Changing roles is also a good moment to review passwords. Ask anyone who gets higher access to use a strong, unique password and two-factor login if your site supports it.
How do you change a role with WP-CLI or code?
Developers can change a role from the command line with the WP-CLI set-role command, or in PHP with the set_role method on a WP_User object.
On the command line, the WP-CLI user set-role command takes a user and a role:
wp user set-role jane editor
WP-CLI is handy when you cannot log in, or when you need to change many users on a server.
In PHP, you can call set_role on a user object:
$user = new WP_User( 42 );
$user->set_role( 'author' );
Run code like this once, such as from a snippets plugin, then remove it. Leaving it active would reset the role on every page load.
How do you give a user more than one role?
WordPress core assigns one role per user in the profile screen, but plugins such as User Role Editor or Members let you add extra roles or individual capabilities.
The User Role Editor plugin is a common choice. It adds options for secondary roles and fine-grained capabilities.
Developers can also use the add_role method on a WP_User object to add a second role in code.
If you need a brand-new role with custom permissions, follow our guide on how to add custom user roles in WordPress.
How do roles work on WooCommerce and multisite?
WooCommerce adds Customer and Shop Manager roles, and multisite adds a Super Admin above every site, with roles set separately for each site in the network.
Shop Manager can manage products and orders without full Administrator rights. It suits staff who run the store but should not install plugins.
On multisite, Super Admins manage the network. Each site has its own users and roles, which you edit from that site's Users screen or from the network's Sites > Edit screen.
Why is a role change not working?
A role change usually fails because your own role lacks permission, a plugin overrides roles, a cache shows old menus, or the user is still logged into an old session.
Try these steps:
- Confirm you are logged in as an Administrator.
- Ask the user to log out and back in.
- Clear page and object caches.
- Check membership or role plugins for their own rules.
- Look for code that sets roles on login.
If a user suddenly sees the message about not being allowed to access a page, our guide to the not allowed to access this page error helps.
How do you keep track of role changes?
WordPress does not keep a history of role changes, so use an activity log plugin to record who changed a role and when.
That record matters on sites with several admins, or after a security incident.
Our guide on how to audit user activity in WordPress compares logging options.
Review your user list every few months. Remove accounts that are no longer needed and lower roles that are higher than necessary.
Frequently asked questions
Who can change user roles in WordPress?
Administrators can change roles on a single site. On multisite, Super Admins can also manage roles across the network. Other roles cannot change roles unless a plugin or custom code gives them the capability to promote users.
Will a user be notified when I change their role?
No. WordPress does not send an email when you change a role. The new access applies the next time the user loads a page. Tell the person directly, especially if you lowered their access or gave them new duties.
Can I undo a role change?
There is no undo button, but you can simply edit the user again and choose the previous role. If you are not sure what it was, an activity log plugin can show the history, provided it was installed before the change.
What role should I give a freelance writer?
Contributor is the safest choice for new or guest writers, since they can write but not publish. Author fits trusted writers who should publish their own posts. Editor is for people who manage everyone's content.
What happens to a user's posts when I change their role?
Their posts stay exactly as they are and remain credited to them. Only their permissions change. If you lower an Author to Contributor, they can no longer publish new posts or edit their published ones.
Sources
- Roles and Capabilities WordPress.org Documentation
- Users Screen WordPress.org Documentation
- wp user set-role WordPress Developer Resources
- User Role Editor WordPress.org
- Least privilege NIST CSRC
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


