Manage organization members

Table of contents

Learn how to manage members for your organization in Docker Hub and the Docker Admin Console.

Invite members

Owners can invite new members to an organization via Docker ID, email address, or with a CSV file containing email addresses. If an invitee does not have a Docker account, they must create an account and verify their email address before they can accept an invitation to join the organization. When inviting members, their pending invitation occupies a seat.

Invite members via Docker ID or email address

Use the following steps to invite members to your organization via Docker ID or email address. To invite a large amount of members to your organization via CSV file, see the next section.

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
Select Invite members.
Select Emails or usernames.
Follow the on-screen instructions to invite members. Invite a maximum of 1000 members and separate multiple entries by comma, semicolon, or space.
Note
When you invite members, you assign them a role. See Roles and permissions for details about the access permissions for each role.
Pending invitations appear in the table. The invitees receive an email with a link to Docker Hub where they can accept or decline the invitation.

Invite members via CSV file

To invite multiple members to an organization via a CSV file containing email addresses:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
Select Invite members.
Select CSV upload.
Select Download the template CSV file to optionally download an example CSV file. The following is an example of the contents of a valid CSV file.
email docker.user-0@example.com docker.user-1@example.com
CSV file requirements:
- The file must contain a header row with at least one heading named email. Additional columns are allowed and are ignored in the import.
- The file must contain a maximum of 1000 email addresses (rows). To invite more than 1000 users, create multiple CSV files and perform all steps in this task for each file.
Create a new CSV file or export a CSV file from another application.
- To export a CSV file from another application, see the application’s documentation.
- To create a new CSV file, open a new file in a text editor, type email on the first line, type the user email addresses one per line on the following lines, and then save the file with a .csv extension.
Select Browse files and then select your CSV file, or drag and drop the CSV file into the Select a CSV file to upload box. You can only select one CSV file at a time.
Note
If the amount of email addresses in your CSV file exceeds the number of available seats in your organization, you cannot continue to invite members. To invite members, you can purchase more seats, or remove some email addresses from the CSV file and re-select the new file. To purchase more seats, see Add seats to your subscription or Contact sales.
After the CSV file has been uploaded, select Review.
Valid email addresses and any email addresses that have issues appear. Email addresses may have the following issues:
- Invalid email: The email address is not a valid address. The email address will be ignored if you send invites. You can correct the email address in the CSV file and re-import the file.
- Already invited: The user has already been sent an invite email and another invite email will not be sent.
- Member: The user is already a member of your organization and an invite email will not be sent.
- Duplicate: The CSV file has multiple occurrences of the same email address. The user will be sent only one invite email.
Follow the on-screen instructions to invite members.
Note
When you invite members, you assign them a role. See Roles and permissions for details about the access permissions for each role.

Pending invitations appear in the table. The invitees receive an email with a link to Docker Hub where they can accept or decline the invitation.

Early Access

The Docker Admin Console is an early access product.

It's available to all company owners and organization owners. You can still manage organizations in Docker Hub, but the Admin Console includes company-level management and enhanced features for organization management.

Invite members via Docker ID or email address

Use the following steps to invite members to your organization via Docker ID or email address. To invite a large amount of members to your organization via CSV file, see the next section.

Sign in to the Admin Console.
Select your organization in the left navigation drop-down menu, and then select Members.
Select Invite.
Select Emails or usernames.
Follow the on-screen instructions to invite members. Invite a maximum of 1000 members and separate multiple entries by comma, semicolon, or space.
Note
When you invite members, you assign them a role. See Roles and permissions for details about the access permissions for each role.
Pending invitations appear in the table. The invitees receive an email with a link to Docker Hub where they can accept or decline the invitation.

Invite members via CSV file

To invite multiple members to an organization via a CSV file containing email addresses:

Sign in to the Admin Console.
Select your organization in the left navigation drop-down menu, and then select Members.
Select Invite.
Select CSV upload.
Select Download the template CSV file to optionally download an example CSV file. The following is an example of the contents of a valid CSV file.
email docker.user-0@example.com docker.user-1@example.com
CSV file requirements:
- The file must contain a header row with at least one heading named email. Additional columns are allowed and are ignored in the import.
- The file must contain a maximum of 1000 email addresses (rows). To invite more than 1000 users, create multiple CSV files and perform all steps in this task for each file.
Create a new CSV file or export a CSV file from another application.
- To export a CSV file from another application, see the application’s documentation.
- To create a new CSV file, open a new file in a text editor, type email on the first line, type the user email addresses one per line on the following lines, and then save the file with a .csv extension.
Select Browse files and then select your CSV file, or drag and drop the CSV file into the Select a CSV file to upload box. You can only select one CSV file at a time.
Note
If the amount of email addresses in your CSV file exceeds the number of available seats in your organization, you cannot continue to invite members. To invite members, you can purchase more seats, or remove some email addresses from the CSV file and re-select the new file. To purchase more seats, see Add seats to your subscription or Contact sales.
After the CSV file has been uploaded, select Review.
Valid email addresses and any email addresses that have issues appear. Email addresses may have the following issues:
- Invalid email: The email address is not a valid address. The email address will be ignored if you send invites. You can correct the email address in the CSV file and re-import the file.
- Already invited: The user has already been sent an invite email and another invite email will not be sent.
- Member: The user is already a member of your organization and an invite email will not be sent.
- Duplicate: The CSV file has multiple occurrences of the same email address. The user will be sent only one invite email.
Follow the on-screen instructions to invite members.
Note
When you invite members, you assign them a role. See Roles and permissions for details about the access permissions for each role.

Pending invitations appear in the table. The invitees receive an email with a link to Docker Hub where they can accept or decline the invitation.

Accept invitation

When an invitation is to a user's email address, they receive a link to Docker Hub where they can accept or decline the invitation. To accept an invitation:

Navigate to your email inbox and open the Docker email with an invitation to join the Docker organization.
To open the link to Docker Hub, select the click here link.
The Docker create an account page will open. If you already have an account, select Already have an account? Sign in. If you do not have an account yet, create an account using the same email address you received the invitation through.
Optional. If you do not have an account and created one, you must navigate back to your email inbox and verify your email address using the Docker verification email.
Once you are signed in to Docker Hub, select Organizations from the top-level navigation menu.
The organizations page will display your invitation. Select Accept.

After accepting an invitation, you are now a member of the organization.

Manage invitations

After inviting members, you can resend or remove invitations as needed.

Resend an invitation

To resend an invitation from Docker Hub:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
In the table, locate the invitee, select the Actions icon, and then select Resend invitation.
Select Invite to confirm.

Early Access

The Docker Admin Console is an early access product.

To resend an invitation from the Admin Console:

Open the Admin Console and select your organization from top-left drop-down menu.
Select Members.
Select the action menu next to the invitee and select Resend invitation.
Select Invite to confirm.

Remove an invitation

To remove a member's invitation from Docker Hub:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
In the table, select the Action icon, and then select Remove member or Remove invitee.
Follow the on-screen instructions to remove the member or invitee.

Early Access

The Docker Admin Console is an early access product.

To remove an invitation from the Admin Console:

Open the Admin Console and select your organization from top-left drop-down menu.
Select Members.
Select the action menu next to the invitee and select Remove invitee.
Select Remove to confirm.

Manage members on a team

Use Docker Hub or the Admin Console to add or remove team members. Organization owners can add a member to one or more teams within an organization.

Add a member to a team

To add a member to a team with Docker Hub:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
Select the Action icon, and then select Add to team.
Note
You can also navigate to Organizations > Your Organization > Teams > Your Team Name and select Add Member. Select a member from the drop-down list to add them to the team or search by Docker ID or email.
Select the team and then select Add.
Note
An invitee must first accept the invitation to join the organization before being added to the team.

Early Access

The Docker Admin Console is an early access product.

To add a member to a team with the Admin Console:

In the Admin Console, select your organization.
Select the team name.
Select Add member. You can add the member by searching for their email address or username.
Note
An invitee must first accept the invitation to join the organization before being added to the team.

Remove a member from a team

Organization owners can remove a member from a team in Docker Hub or Admin Console. Removing the member from the team will revoke their access to the permitted resources.

To remove a member from a specific team with Docker Hub:

Sign in to Docker Hub.
Select Organizations, your organization, Teams, and then the team.
Select the X next to the user’s name to remove them from the team.
When prompted, select Remove to confirm.

Early Access

The Docker Admin Console is an early access product.

To remove a member from a specific team with the Admin Console:

In the Admin Console, select your organization.
Select the team name.
Select the X next to the user's name to remove them from the team.
When prompted, select Remove to confirm.

Update a member role

Organization owners can manage roles within an organization. If an organization is part of a company, the company owner can also manage that organization's roles. If you have SSO enabled, you can use SCIM for role mapping.

Note
If you're the only owner of an organization, you need to assign a new owner before you can edit your role.

To update a member role:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
Find the username of the member whose role you want to edit. In the table, select the Actions icon.
Select Edit role.
Select their organization, select the role you want to assign, and then select Save.

Export members CSV file

Owners can export a CSV file containing all members. The CSV file for a company contains the following fields:

Name: The user's name
Username: The user's Docker ID
Email: The user's email address
Member of Organizations: All organizations the user is a member of within a company
Invited to Organizations: All organizations the user is an invitee of within a company
Account Created: The time and date when the user account was created

To export a CSV file of the members:

Sign in to Docker Hub.
Select Organizations, your organization, and then Members.
Select the Action icon and then select Export users as CSV.