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