organizations.md

Organizations

Organizations are named groups of users with an associated JSON settings file (with search scopes, saved queries, etc.). These settings take effect for all users who are members of the organization.

To create an organization, go to http(s)://[hostname]/organizations/new on your Sourcegraph instance (or, from any page, click your username and then New organization).

You (and any other organization members, and any site admin) may add or remove members from the organization's members page at http(s)://[hostname]/organizations/[org-name]/members.

To automatically join all users on your instance to a specific organization, create the organization first and then set the auth.userOrgMap site configuration option:

{
  // ...
  "auth.userOrgMap": {
    // All users ("*") will be automatically joined to the "example-corp" org.
    // Currently "*" (all users) is the only supported key.
    "*": ["example-corp"] // The array values refer to org names you've already created.
  }
  // ...
}

NOTE: Users will not be automatically populated to the org immediately after adding auth.userOrgMap to your site config json. Instead the org will be populated with all users upon the creation of any new user.