> ## Documentation Index
> Fetch the complete documentation index at: https://docs.envzero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage organizations

> Set up and manage organizations as the top-level entity for projects, templates, variables, and policies in env zero, including SSO configuration.

## What is an organization?

An *Organization* is the highest level logical entity in env zero.

All *Projects*, *Templates*, *Variables*, *Policies*, and *Environments* are defined for a specific organization.  Organizations are logically separate from each other, and do not share any entities.

Most users belong to a single organization, but they can be a member of several organizations, with different roles and permissions for each one.

An organization is the highest level scope for settings such as [Variables and Secrets](https://docs.envzero.com/guides/admin-guide/variables.md), and [Policies](https://docs.envzero.com/guides/policies-governance/policies.md).

Only users with *administrator* role in an organization, can change the settings or invite new users for that organization.

## Select the active organization

Users in env zero have one *Active Organization*. This is shown at the upper left of the screen.

To change the Active Organization, click the organization name, and then select an organization from the list.

## Join an organization

A user can join an organization in the following ways:

* When joining env zero the user is added to the env zero Demo Organization.
* By invitation, from an organization administrator.
* By creating a new organization, in which case the user becomes the first user and administrator for the new organization.
* Through Single Sign-On (SSO), if configured for the organization. Users authenticating via SSO are automatically provisioned with appropriate roles.

## Create an Organization

To create a new organization, click *Active Organization* at the upper right, and then click *Create Organization*.

Enter a name, description (optional), and URL for the organization logo (optional).\
You can edit these settings later.

Once the organization is created, it automatically becomes the *Active Organization*. You can add a user to the organization in the *Settings* tab.

## Organization Settings

*Organization* is the highest scope for configuration in env zero.  All other entities inherit the organization's settings.

Only a user with the *administrator* role can view or edit the organization settings.

To edit the settings, select the *Settings* tab at the upper left.

Organization settings include name and logo, user management, SSO configuration, API Key management, and policies.

*Variables* configuration is accessed in the *Variables* tab and is accessible to non-administrator users as well.

## Finding my Organization ID

Sometimes you may need your organization ID for various reasons. Here's how you can find it:

1. Click on your organization icon in the bottom left corner
2. Select `Settings` from the left side panel
3. Go to the `General` tab under `Organization Settings`
4. Copy the Organization `ID` as shown in the screenshot below

![Interface screenshot showing configuration options](https://mintcdn.com/envzero-b61043c8/pcx_nh6zT3at7dYL/images/guides/admin-guide/c982227f0a1d55883c693dc85deea22d71e79e638bbff4193535b10ecaade6e0-cleanshot_2024-09-29_at_5.png?fit=max\&auto=format\&n=pcx_nh6zT3at7dYL\&q=85\&s=0b1f3b4a28aa6150f7643fc9f854c16d)

## Single Sign-On (SSO)

Organizations can configure Single Sign-On to authenticate users through an external identity provider. This enables centralized user management, enforces your security policies, and meets enterprise compliance requirements.

SSO can be configured directly from Organization Settings > SSO tab. See [Self-service SSO integration](https://docs.envzero.com/guides/sso-integrations/self-service-sso.md) for setup instructions.

## Next steps

* [Create a project](https://docs.envzero.com/guides/admin-guide/projects.md#create-a-project) to separate environments and their access rights
* [Group users into teams](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/teams.md#creating-a-team)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.