The key to managing package access in an Organization is teams. Teams are sets of Organization Members that have defined privileges for a set of packages that are controlled by the Organization. This page will teach you how to create and manage the Membership of your Organization's team from the web interface.
If you would like to manage the Membership of your team from the npm command line interface (CLI), you can use:
npm team
Learn more about npm team here.
If you are looking for how to manage a team's package access, check out this doc.
You will need to have the Owner or Admin role to perform this work. For more information on roles, check out the Roles and Privileges doc.
To manage your Organization's teams, navigate to your
Organization's landing page. You can find it at
https://www.npmjs.com/org/<org_name>.
Once you are on your Organization's landing page, click the "Teams" tab.
You can also just point your browser at
https://www.npmjs.com/org/<org_name>/teams.
To create a team:
- Click the "Create a Team" button.
- Give your team a name. Your team name must be lower case and have no spaces or punctuation. Choose wisely! A team's name cannot be changed.
- Click the "make it so" button.
- Inviting an Organization Member to a new team does not send that user an email. Make sure to tell your new team Member that you added them.
- New teams do not have any package access by default. Once you create a team, you should add package access to the team. (Learn more about managing Package Access).
To manage the membership of a team, navigate to your team's landing page.
You can find a list of your teams at https://www.npmjs.com/org/<org_name>/teams.
From this list, you can click the value in the "Members" column.
- If the team has Members, this value will be the current Member count. Clicking this value will bring you to the Members tab for this team.
- If the team does not have any Members, this value will read "invite users". Clicking this value will bring you to the team Member invite page.
You can also navigate to your team page directly by pointing your browser at
https://www.npmjs.com/org/<org_name>/teams/<team_name>.
From there, click the "Members" tab. You'll use this interface to manage the Membership of your team.
Add members. As you type a name, possible choices will appear in the drop-down.
Click the Green +Add-User button when the username is complete.
The new member will be listed with others on the team page.
To add a Member to a team:
- Enter the npm username of the user you would like to add to your team. A drop-down will appear.
- Click the "add" button.
- Repeat this until you have added all the Members you want.
- When you are done, click a button or select a tab item to go on to your next task.
- Adding a Member to a team does not send them an email. Let your new team Member know that you added them to a team!
- You cannot add a user who is not a Member of your Organization to a team. If you need to add a user who is not a member, ask an Owner to invite them to the Organization so that you can add them to a team. (Learn more about managing Members).
- Organization Members cost $7/Member/month if the Organization has private packages, even if the teams the Member is a part of do not have access to private packages.
To remove a Member from a team:
- Locate the Member in the list of Members.
- Hover over the X at the end of the row. It will turn red. Click the red X.
- Removing a Member from a team, even if it is the only team they are associated with, will not remove the Member from the Organization. If you would like to remove the Member from the Organization, you will need to be an Owner or ask an Owner. (Learn more about managing Members).