--- section: cli-commands title: npm-team description: Manage organization teams and team memberships --- # npm-team(1) ## Manage organization teams and team memberships ### Synopsis ```bash npm team create <scope:team> npm team destroy <scope:team> npm team add <scope:team> <user> npm team rm <scope:team> <user> npm team ls <scope>|<scope:team> npm team edit <scope:team> ``` ### Description Used to manage teams in organizations, and change team memberships. Does not handle permissions for packages. Teams must always be fully qualified with the organization/scope they belong to when operating on them, separated by a colon (`:`). That is, if you have a `wombats` team in a `wisdom` organization, you must always refer to that team as `wisdom:wombats` in these commands. If you have two-factor authentication enabled in `auth-and-writes` mode, then you can provide a code from your authenticator with `[--otp <otpcode>]`. If you don't include this then you will be prompted. * create / destroy: Create a new team, or destroy an existing one. Note: You cannot remove the `developers` team, <a href="https://docs.npmjs.com/about-developers-team" target="_blank">learn more.</a> * add / rm: Add a user to an existing team, or remove a user from a team they belong to. * ls: If performed on an organization name, will return a list of existing teams under that organization. If performed on a team, it will instead return a list of all users belonging to that particular team. * edit: Edit a current team. ### Details `npm team` always operates directly on the current registry, configurable from the command line using `--registry=<registry url>`. In order to create teams and manage team membership, you must be a *team admin* under the given organization. Listing teams and team memberships may be done by any member of the organizations. Organization creation and management of team admins and *organization* members is done through the website, not the npm CLI. To use teams to manage permissions on packages belonging to your organization, use the `npm access` command to grant or revoke the appropriate permissions. ### See Also * [npm access](/cli-commands/npm-access) * [npm registry](/using-npm/registry)
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
npm-access.md | File | 2.87 KB | 0644 |
|
npm-adduser.md | File | 2.93 KB | 0644 |
|
npm-audit.md | File | 4.08 KB | 0644 |
|
npm-bin.md | File | 452 B | 0644 |
|
npm-bugs.md | File | 1.08 KB | 0644 |
|
npm-build.md | File | 645 B | 0644 |
|
npm-bundle.md | File | 416 B | 0644 |
|
npm-cache.md | File | 2.73 KB | 0644 |
|
npm-ci.md | File | 1.92 KB | 0644 |
|
npm-completion.md | File | 936 B | 0644 |
|
npm-config.md | File | 1.62 KB | 0644 |
|
npm-dedupe.md | File | 1.44 KB | 0644 |
|
npm-deprecate.md | File | 953 B | 0644 |
|
npm-dist-tag.md | File | 2.95 KB | 0644 |
|
npm-docs.md | File | 1.14 KB | 0644 |
|
npm-doctor.md | File | 4.65 KB | 0644 |
|
npm-edit.md | File | 1.07 KB | 0644 |
|
npm-explore.md | File | 1.04 KB | 0644 |
|
npm-fund.md | File | 1.59 KB | 0644 |
|
npm-help-search.md | File | 910 B | 0644 |
|
npm-help.md | File | 989 B | 0644 |
|
npm-hook.md | File | 1.88 KB | 0644 |
|
npm-init.md | File | 2.17 KB | 0644 |
|
npm-install-ci-test.md | File | 438 B | 0644 |
|
npm-install-test.md | File | 832 B | 0644 |
|
npm-install.md | File | 19.03 KB | 0644 |
|
npm-link.md | File | 2.75 KB | 0644 |
|
npm-logout.md | File | 1.28 KB | 0644 |
|
npm-ls.md | File | 2.57 KB | 0644 |
|
npm-org.md | File | 1.01 KB | 0644 |
|
npm-outdated.md | File | 3.86 KB | 0644 |
|
npm-owner.md | File | 1.22 KB | 0644 |
|
npm-pack.md | File | 1.01 KB | 0644 |
|
npm-ping.md | File | 519 B | 0644 |
|
npm-prefix.md | File | 678 B | 0644 |
|
npm-profile.md | File | 2.89 KB | 0644 |
|
npm-prune.md | File | 1.38 KB | 0644 |
|
npm-publish.md | File | 3.12 KB | 0644 |
|
npm-rebuild.md | File | 495 B | 0644 |
|
npm-repo.md | File | 774 B | 0644 |
|
npm-restart.md | File | 962 B | 0644 |
|
npm-root.md | File | 438 B | 0644 |
|
npm-run-script.md | File | 3.49 KB | 0644 |
|
npm-search.md | File | 2.85 KB | 0644 |
|
npm-shrinkwrap.md | File | 1004 B | 0644 |
|
npm-star.md | File | 591 B | 0644 |
|
npm-stars.md | File | 614 B | 0644 |
|
npm-start.md | File | 798 B | 0644 |
|
npm-stop.md | File | 452 B | 0644 |
|
npm-team.md | File | 2.2 KB | 0644 |
|
npm-test.md | File | 469 B | 0644 |
|
npm-token.md | File | 2.8 KB | 0644 |
|
npm-uninstall.md | File | 1.53 KB | 0644 |
|
npm-unpublish.md | File | 1.45 KB | 0644 |
|
npm-update.md | File | 3.39 KB | 0644 |
|
npm-version.md | File | 4.47 KB | 0644 |
|
npm-view.md | File | 3.19 KB | 0644 |
|
npm-whoami.md | File | 385 B | 0644 |
|
npm.md | File | 5.31 KB | 0644 |
|