1 ---
2 title: npm-org
3 section: 1
4 description: Manage orgs
5 github_repo: npm/cli
6 github_branch: release/v7
7 github_path: docs/content/commands/npm-org.md
8 redirect_from:
9 - /cli-documentation/v7/cli-commands/npm-org
10 - /cli-documentation/v7/cli-commands/org
11 - /cli-documentation/v7/commands/npm-org
12 - /cli-documentation/v7/commands/org
13 - /cli-documentation/v7/npm-org
14 - /cli-documentation/v7/org
15 - /cli/v7/cli-commands/npm-org
16 - /cli/v7/cli-commands/org
17 - /cli/v7/commands/org
18 - /cli/v7/npm-org
19 - /cli/v7/org
20 ---
21
22 ### Synopsis
23
24 ```bash
25 npm org set <orgname> <username> [developer | admin | owner]
26 npm org rm <orgname> <username>
27 npm org ls <orgname> [<username>]
28 ```
29
30 Note: This command is unaware of workspaces.
31
32 ### Example
33
34 Add a new developer to an org:
35
36 ```bash
37 $ npm org set my-org @mx-smith
38 ```
39
40 Add a new admin to an org (or change a developer to an admin):
41
42 ```bash
43 $ npm org set my-org @mx-santos admin
44 ```
45
46 Remove a user from an org:
47
48 ```bash
49 $ npm org rm my-org mx-santos
50 ```
51
52 List all users in an org:
53
54 ```bash
55 $ npm org ls my-org
56 ```
57
58 List all users in JSON format:
59
60 ```bash
61 $ npm org ls my-org --json
62 ```
63
64 See what role a user has in an org:
65
66 ```bash
67 $ npm org ls my-org @mx-santos
68 ```
69
70 ### Description
71
72 You can use the `npm org` commands to manage and view users of an organization. It supports adding and removing users, changing their roles, listing them, and finding specific ones and their roles.
73
74 ### Configuration
75
76 #### `registry`
77
78 - Default: "https://registry.npmjs.org/"
79 - Type: URL
80
81 The base URL of the npm registry.
82
83 #### `otp`
84
85 - Default: null
86 - Type: null or String
87
88 This is a one-time password from a two-factor authenticator. It's needed when publishing or changing package permissions with `npm access`.
89
90 If not set, and a registry response fails with a challenge for a one-time password, npm will prompt on the command line for one.
91
92 #### `json`
93
94 - Default: false
95 - Type: Boolean
96
97 Whether or not to output JSON data, rather than the normal output.
98
99 - In `npm pkg set` it enables parsing set values with JSON.parse() before saving them to your `package.json`.
100
101 Not supported by all npm commands.
102
103 #### `parseable`
104
105 - Default: false
106 - Type: Boolean
107
108 Output parseable results from commands that write to standard output. For `npm search`, this will be tab-separated table format.
109
110 ### See Also
111
112 - [using orgs](/cli/v7/using-npm/orgs)
113 - [Documentation on npm Orgs](https://docs.npmjs.com/orgs/)