Manage organization members

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.

1. Sign in to Docker Home and select your organization from the top-left account drop-down.
2. Select Members, then Invite.
3. Select Emails or usernames.
4. Follow the on-screen instructions to invite members. Invite a maximum of 1000 members and separate multiple entries by comma, semicolon, or space.

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. 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:

1. Sign in to Docker Home and select your organization from the top-left account drop-down. Select Members > Invite > CSV upload.

2. Optional. Select Download the template CSV file to download an example CSV file. The following is an example of the contents of a valid CSV file:

   textCopy

   email
   [email protected]
   [email protected]
   

   The example file demonstrates 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.

3. 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.

4. 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.

5. After the CSV file has been uploaded, select Review to identify any invalid email addresses, already invited users, invited users who are already members, or duplicated email addresses within the same CSV file.

6. Follow the on-screen instructions to invite members.

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 API

You can bulk invite members using the Docker Hub API. For more information, see the Bulk create invites API endpoint.

Accept invitation

After receiving an email invitation, users can access a link to Docker Hub where they can accept or decline the invitation.

To accept an invitation:

1. Check your email inbox and open the Docker email with an invitation to join the Docker organization.
2. To open the link to Docker Hub, select the click here link.
3. 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.
4. 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.
5. Once you are signed in to Docker Hub, select My Hub from the top-level navigation menu.
6. Select Accept on your invitation.

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

Invitation email links expire after 14 days. If your email link has expired, you can sign in to Docker Hub with the email address the link was sent to and accept the invitation from the Notifications panel.

Manage invitations

After inviting members, you can resend or remove invitations as needed. Each invitee occupies one seat, so if the amount of email addresses in your CSV file exceeds the number of available seats in your organization, you won't be able to invite more members.

[!TIP] Need to manage more than 1,000 team members? Upgrade to Docker Business for unlimited user invites and advanced role management. You can also add seats to your subscription.

Resend an invitation

You can send individual invitations, or bulk invitations from the Admin Console.

To resend an individual invitation:

1. Sign in to Docker Home and select your organization.
2. Select Members.
3. Select the action menu next to the invitee and select Resend.
4. Select Invite to confirm.

To bulk resend invitations:

1. Sign in to Docker Home and select your organization.
2. Select Members.
3. Use the checkboxes next to Usernames to bulk select users.
4. Select Resend invites.
5. Select Resend to confirm.

Remove an invitation

To remove an invitation from the Admin Console:

1. Sign in to Docker Home and select your organization.
2. Select Members.
3. Select the action menu next to the invitee and select Remove invitee.
4. 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 the Admin Console:

1. Sign in to Docker Home and select your organization.
2. Select Teams.
3. Select the team name.
4. Select Add member. You can add the member by searching for their email address or username.

An invitee must first accept the invitation to join the organization before being added to the team.

Remove members from teams

If your organization uses single sign-on (SSO) with SCIM enabled, you should remove members from your identity provider (IdP). This automatically removes members from Docker. If SCIM is disabled, follow procedures in this doc to remove members manually in Docker.

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 the Admin Console:

1. Sign in to Docker Home and select your organization.
2. Select Teams, then choose the name of the team member you want to remove.
3. Select the X next to the user's name to remove them from the team.
4. 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.

To update a member role in the Admin Console:

1. Sign in to Docker Home and select your organization.
2. Select Members.
3. Find the username of the member whose role you want to edit. Select the Actions menu, then Edit role.

If you're the only owner of an organization and you want to edit your role, assign a new owner for your organization so you can edit your role.

Export members CSV file

{{< summary-bar feature_name="Admin orgs" >}}

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 your members:

1. Sign in to Docker Home and select your organization.
2. Select Members.
3. Select the download icon to export a CSV file of all members.