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

# Organizations

> Create organizations and manage member access

Organizations are the top-level containers in Mistrive. They group projects together and provide a boundary for access control. Every project belongs to an organization.

## Creating an organization

<Note>
  Only global administrators can create organizations.
</Note>

Navigate to **Global Settings → Organizations** and select **Create Organization**.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mistriveinc/jjSQI289HnCoAcnz/images/create-org-light.png?fit=max&auto=format&n=jjSQI289HnCoAcnz&q=85&s=09b82933c1ea35eaa60c9ed546621dd4" alt="Mistrive Create Organization form in light mode" width="2804" height="1662" data-path="images/create-org-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mistriveinc/jjSQI289HnCoAcnz/images/create-org-dark.png?fit=max&auto=format&n=jjSQI289HnCoAcnz&q=85&s=49e53b80e10367d55efaf5dbc3d70e72" alt="Mistrive Create Organization form in dark mode" width="2804" height="1662" data-path="images/create-org-dark.png" />
</Frame>

<Steps>
  <Step title="Enter organization details">
    Provide a display name for the organization. Optionally specify a custom ID—if omitted, the system generates one automatically.
  </Step>

  <Step title="Create the organization">
    Submit the form. The new organization appears in your organizations list.
  </Step>
</Steps>

## Organization roles

When you add a member to an organization, you assign them one of four roles. Each role grants different levels of access to the organization's projects.

| Role       | Description                                                                                                    |
| ---------- | -------------------------------------------------------------------------------------------------------------- |
| **Member** | Can access the organization but has no implicit access to projects. Must be granted project access separately. |
| **Viewer** | Read-only access to all projects in the organization.                                                          |
| **Editor** | Read and write access to all projects in the organization.                                                     |
| **Owner**  | Full access including the ability to manage projects and organization settings.                                |

Roles inherit upward: an Owner automatically has Editor permissions, an Editor automatically has Viewer permissions, and all roles include Member status.

## Adding members

Add users to your organization from the organization settings page.

Navigate to your organization and open **Settings**. Select **Add Member** to open the member drawer.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mistriveinc/jjSQI289HnCoAcnz/images/add-org-member-light.png?fit=max&auto=format&n=jjSQI289HnCoAcnz&q=85&s=83a80d7ce756fbe8a7f900078454ced3" alt="Mistrive Add Member form in light mode" width="1840" height="3570" data-path="images/add-org-member-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mistriveinc/jjSQI289HnCoAcnz/images/add-org-member-dark.png?fit=max&auto=format&n=jjSQI289HnCoAcnz&q=85&s=37d1515b194811efe86cd236938b9275" alt="Mistrive Add Member form in dark mode" width="1840" height="3570" data-path="images/add-org-member-dark.png" />
</Frame>

<Steps>
  <Step title="Enter the user's email">
    Type the email address of the user you want to add. The user must already exist in the system.
  </Step>

  <Step title="Select a role">
    Choose the appropriate role based on what access the user needs.
  </Step>

  <Step title="Add the member">
    Confirm to add the user to the organization.
  </Step>
</Steps>

## Removing members

From the organization settings, locate the member in the list and select the remove option. This revokes their organization membership and any access inherited from organization-level roles.

<Warning>
  Removing a member from an organization does not delete their user account. They can still be added back later or remain a member of other organizations.
</Warning>

## What's next

Once you have an organization set up with members:

1. [Create projects](/user-guides/projects) within the organization
2. [Configure project-level IAM](/user-guides/projects#managing-project-iam) for fine-grained access control