How to give an agency access to your WordPress site
Updated By Adcato
In WordPress, an Administrator goes to Users > Add User, enters a username and the agency person's email address, picks a Role and clicks Add User. WordPress creates the user at once and, with Send User Notification ticked, emails the person a link to set their password; a multisite network sends an invitation instead. On a single site, only the Administrator role can install plugins, change themes or manage users; Editor can publish and manage all posts and pages without those rights.
This guide covers a self-hosted WordPress site, which includes WooCommerce stores, and WordPress.com, which has its own screens further down. The agency only has to send the email address of each person who needs access.
Before you start
- You need to be an Administrator of the site. On a single site, WordPress's roles reference gives only Administrators the capabilities to add, edit and delete users.
- One user per person. WordPress.com's guide says giving someone your username and password is a security risk. A user of their own also lets you remove the agency later without changing your password.
- One email address per user. WordPress requires each user's email address to be unique, so use an address the agency person does not already use on your site.
- Pick the role first (see "Which role to give" below).
Add the agency on a self-hosted site
The labels are from WordPress's own source code for the current release, because the documentation page for this screen still shows an older version. Older versions call the menu item and the button Add New User.
- Log in to your site's admin area. For most sites, that is your site's address followed by /wp-admin.
- In the menu on the left, click Users, then Add User.
- Enter a Username for the agency person. WordPress says it cannot be changed once the user is added.
- Enter their address under Email. First Name, Last Name and Website are optional.
- Leave Send User Notification ticked: "Send the new user an email about their account".
- Under Role, select the role.
- Click Add User at the bottom of the screen.
On a single site, WordPress assigns a password itself, and the email to the new user contains a link to set their own.
On a multisite network, the screen has no Send User Notification box: Add User sends a new person an invitation email, and WordPress creates their account only when they click the confirmation link in it. The screen may also offer Add Existing User for someone who already has an account on the network. WordPress then emails an invitation, and the person has to click a confirmation link before they are added to your site.
Which role to give
WordPress's built-in roles, from its roles reference:
- Administrator: all the administration features of a single site. On a single site, only Administrators can install, update and delete plugins and themes, edit files, and add, edit or delete users.
- Editor: publishes and manages posts and pages, including other people's, and manages categories, comments and uploads. No plugins, themes, settings or users.
- Author: publishes and manages their own posts and uploads files.
- Contributor: writes and manages their own posts, but cannot publish them.
A WooCommerce store adds Shop Manager. WooCommerce's roles page says it manages the store without full Administrator access: WooCommerce settings and reports, products, orders including refunds, coupons and customers, plus the general editor capabilities for posts and pages.
Our advice, based on those descriptions:
- An SEO or content agency: Editor.
- An agency that adds tracking or an SEO plugin: installing a plugin needs Administrator on a single site. Either give Administrator for that work, or install the plugin yourself and give Editor.
- A web agency that maintains the site, plugins and theme: Administrator. No smaller built-in role can update plugins or themes.
- An agency that runs your shop's products, orders or coupons: Shop Manager.
- A copywriter: Author, or Contributor if you want to approve each post before it goes live.
What the agency person does
On a single site, the agency person opens WordPress's email, sets a password with the link and logs in. If the email does not arrive, open the user under Users, click Send Reset Link on their profile, and WordPress emails them a new link without changing their password.
Change the role or remove the agency
To lower the agency's role, click its username under Users, choose another Role and click Update User.
To remove the agency person on a single site:
- Go to Users and hover over the agency's user.
- Click Delete.
- If the user owns content, WordPress asks what should be done with it. Choose Attribute all content to another user. and pick a user, unless you want Delete all content.
- Click Confirm Deletion.
On a multisite network, Remove takes the person off your site without deleting their content; confirm with Confirm Removal.
WordPress.com sites
WordPress.com has its own screens, and its guide has a tab for each of its two admin styles.
With the WP Admin style:
- In your site's dashboard, go to Users > Add New User.
- Fill in the username and email address.
- Select a role from the Role dropdown.
- Optionally, check Invite user to WordPress.com, which invites them to create a WordPress.com account with their account on your site.
- Click Add New User.
Until they accept, the user shows "Pending invite" in the "SSO Status" column. Hover over them to revoke or resend the invitation.
With the Default style:
- Go to Users > All Users.
- On the Team tab, click Add a team member.
- Select a role from the Role dropdown.
- Enter the agency person's email address or WordPress.com username.
- Click Send invitation.
The person clicks Accept invitation in the email and then appears under Users > All Users. To withdraw an invitation, select it under pending invites and click Revoke.
To remove the agency later, WordPress.com's user management guide says: in the WP Admin style, hover over the user under Users > All Users, click Delete, choose what happens to their content and click Confirm Deletion. In the Default style, click the user and use the button that reads "Remove" followed by their name, or Delete user. An administrator can remove anyone except the site owner.
Troubleshooting
"Sorry, you are not allowed to create users."
WordPress shows this when your user may not create users. On a single site, only Administrators can. Ask an Administrator to add the agency, or to raise your role.
"This email is already registered. Please choose another one."
The address already belongs to a user on your site. Check Users for it: the agency may already have a user, and you only need to change its role. On a multisite network, "That user is already a member of this site." means the person is already on your site.
The agency person never got the email
On a single site, check that Send User Notification was ticked, and ask them to look in spam. Then send a new link with Send Reset Link on the user's profile.
"User blocked invites." on WordPress.com
WordPress.com says the person has blocked invitation emails from WordPress.com. If they do want to join, contact WordPress.com support to unblock them.
Questions
Should I just send the agency my WordPress login?
No. Give each agency person their own user. WordPress.com calls sharing your username and password a security risk, and with separate users you can remove the agency later without changing your own password.
Which role does an SEO agency need?
Editor covers writing and editing all posts and pages. If the agency also has to install or update an SEO plugin, it needs Administrator on a single site, or you install the plugin for it.
Can I give the agency temporary access?
WordPress's Add User screen has no end date. Note the date the work ends, then lower the role or delete the user; WordPress.com's advice is to remove a developer's access once the work is complete.
What happens to the agency's posts when I delete its user?
If the user owns content, WordPress asks what to do with it: delete all of it, or attribute all of it to another user. Choose another user to keep the posts and pages.
Checked against
- wp-admin/user-new.php, the Add User screen (WordPress source, 7.1 branch), read
- wp-admin/menu.php, the admin menu (WordPress source, 7.1 branch), read
- wp-admin/menu.php, the admin menu (WordPress source, 6.4 branch), read
- wp-admin/users.php, the Users screen (WordPress source, 7.1 branch), read
- wp-admin/user-edit.php, the Edit User screen (WordPress source, 7.1 branch), read
- wp-admin/includes/user.php (WordPress source, 7.1 branch), read
- Roles and Capabilities (WordPress.org Documentation), read
- Users Add New screen (WordPress.org Documentation), read
- Roles and Capabilities (WooCommerce Documentation), read
- Invite users to your site (WordPress.com Support), read
- Manage users on your site (WordPress.com Support), read