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