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