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

# Organizations

> Create and manage organizations for team collaboration in CVAT

Organizations enable teams to collaborate on annotation projects by sharing resources, managing members, and controlling access to tasks and datasets.

<Info>
  An organization acts as a shared workspace where multiple users can work together with role-based permissions.
</Info>

## Personal Workspace vs Organizations

### Personal Workspace

Your default workspace when no organization is selected:

* All resources are linked to your personal account
* Resources cannot be shared with other users
* Subject to [Free plan limits](/account/subscription-plans) unless you have a Solo subscription
* Identified by a checkmark in the organization menu

### Organizations

Shared workspaces for team collaboration:

* Resources belong to the organization
* Multiple members with different [roles](/account/user-roles)
* Team subscription benefits apply to all members
* Centralized management and billing

## Creating an Organization

To create a new organization:

<Steps>
  <Step title="Access Organization Menu">
    Click your username in the top menu, then select **Organization** > **+ Create**
  </Step>

  <Step title="Fill Organization Details">
    Complete the organization creation form:

    | Field            | Required | Description                                             |
    | ---------------- | -------- | ------------------------------------------------------- |
    | **Short name**   | Yes      | Slug used in URLs and displayed in menus (max 16 chars) |
    | **Full name**    | No       | Complete organization name                              |
    | **Description**  | No       | Organization purpose and details                        |
    | **Email**        | No       | Organization contact email                              |
    | **Phone number** | No       | Organization contact phone                              |
    | **Location**     | No       | Organization address                                    |
  </Step>

  <Step title="Submit">
    Click **Submit** to create the organization
  </Step>
</Steps>

<Info>
  You are automatically assigned the Owner role when you create an organization.
</Info>

**Code Reference**: Organization model defined in `cvat/apps/organizations/models.py:21-36`

## Switching Between Workspaces

You can work in multiple organizations and easily switch between them:

1. Click your **Username** in the top menu
2. Select **Organization** from the dropdown
3. Choose the desired organization or **Personal workspace**

<Tip>
  The currently active workspace is marked with a checkmark and displayed under your username.
</Tip>

### Managing Multiple Organizations

If you have more than 10 organizations:

* A **Switch organization** option appears in the menu
* Opens a searchable dialog to select from all organizations
* Useful for users who are members of many teams

## Organization Settings

Access organization settings to manage details and members:

<Steps>
  <Step title="Activate Organization">
    Switch to the organization you want to manage
  </Step>

  <Step title="Open Settings">
    Click **Username** > **Organization** > **Settings**
  </Step>
</Steps>

From the organization page, you can:

* Edit organization information
* Invite and manage members
* View member roles
* Remove members
* Delete the organization

## Managing Members

### Inviting Members

<Warning>
  Only Owners and Maintainers can invite new members to an organization.
</Warning>

To invite members:

<Steps>
  <Step title="Open Invite Form">
    Go to the Organization page and click **Invite members**
  </Step>

  <Step title="Enter Member Details">
    Fill in the invitation form:

    * **Email**: The email address of the user to invite
    * **Role**: Select Worker, Supervisor, or Maintainer
  </Step>

  <Step title="Send Invitation">
    Click **OK** to send the invitation email
  </Step>
</Steps>

The invited user will receive an email with a link to:

* Create a CVAT account (if they don't have one)
* Accept the invitation and join the organization

<Info>
  You can invite multiple users at once by clicking **Invite more** in the form.
</Info>

**Code Reference**: Invitation model in `cvat/apps/organizations/models.py:66-116`

### Member Roles

When inviting members, you can assign these roles:

<CardGroup cols={2}>
  <Card title="Worker" icon="user">
    Access only to assigned tasks and jobs. Best for annotators and validators.
  </Card>

  <Card title="Supervisor" icon="user-tie">
    Can create and assign tasks. Best for project managers.
  </Card>

  <Card title="Maintainer" icon="user-shield">
    Full administrative access except deleting organization. Best for team leads.
  </Card>

  <Card title="Owner" icon="crown">
    Full control including organization deletion. Automatically assigned to creator.
  </Card>
</CardGroup>

See [User Roles](/account/user-roles) for detailed permission information.

### Changing Member Roles

Owners and Maintainers can modify member roles:

1. Go to the Organization page
2. Find the member in the members list
3. Click the role dropdown next to their name
4. Select the new role

<Warning>
  * Maintainers cannot change Owner or other Maintainer roles
  * The Owner role cannot be transferred (this is a future feature)
</Warning>

**Code Reference**: Role change permissions in `cvat/apps/organizations/rules/memberships.rego:88-111`

### Removing Members

**By Administrators**:

* Owners can remove any member except themselves
* Maintainers can remove Workers and Supervisors (not Owners or other Maintainers)
* Click the **Bin** icon next to a member's name

**By Members**:

* Any member can leave an organization (except the Owner)
* Go to Organization page > **Leave organization**

<Warning>
  The Owner cannot leave or be removed from an organization. To transfer ownership, you must first delete and recreate the organization.
</Warning>

### Managing Invitations

View pending invitations:

1. Click **Username** > **Organization** > **Invitations**
2. You'll see a list of all pending invitations

**Resending invitations**:

* Click the three dots next to an invitation
* Select **Resend invitation**

**Removing invitations**:

* Click the three dots next to an invitation
* Select **Remove invitation**

<Info>
  Invitations expire after the number of days configured in `ORG_INVITATION_EXPIRY_DAYS` (default in source code).
</Info>

## Transferring Resources

You can move projects and tasks between organizations and your personal workspace:

<Steps>
  <Step title="Open Actions Menu">
    Find the project or task you want to transfer
    Click the **Actions** menu (three dots)
  </Step>

  <Step title="Select Organization">
    Choose **Organization** from the menu
    Select the destination workspace
  </Step>

  <Step title="Confirm Transfer">
    Review the transfer confirmation
    Choose how to handle cloud storage:

    * **Move & Detach**: Remove cloud storage connections
    * **Move & Auto Match**: Automatically match similar cloud storage in destination
  </Step>

  <Step title="Complete Transfer">
    Click **Move** to complete the transfer
  </Step>
</Steps>

<Warning>
  Transferring resources will affect:

  * Cloud storage connections (must be reconfigured)
  * Member access (members in the destination workspace gain access)
  * Permissions (based on destination workspace roles)
</Warning>

## Organization Data Model

Understanding the organization structure:

```python theme={null}
Organization
├── slug: Unique identifier (max 16 characters)
├── name: Full organization name
├── description: Optional description
├── contact: JSON field for contact information
├── owner: Organization creator (User reference)
└── members: List of Memberships

Membership
├── user: Reference to User
├── organization: Reference to Organization
├── role: One of [WORKER, SUPERVISOR, MAINTAINER, OWNER]
├── is_active: Boolean (true after invitation accepted)
└── joined_date: Timestamp of invitation acceptance

Invitation
├── key: Unique invitation token
├── membership: Reference to Membership
├── owner: User who sent invitation
├── created_date: When invitation was created
├── sent_date: When invitation email was sent
└── expired: Computed property based on sent_date
```

**Code Reference**: `cvat/apps/organizations/models.py`

## Organization Subscription

<Info>
  Organization subscriptions work differently from personal subscriptions. See [Subscription Plans](/account/subscription-plans) for details.
</Info>

Key points:

* Team plan subscriptions are per organization
* All organization members benefit from the subscription
* Owner is responsible for subscription management
* Member count affects pricing on Team plans

## Deleting an Organization

<Warning>
  **This action cannot be undone!** Deleting an organization will permanently remove:

  * All tasks and projects
  * All annotations and datasets
  * All jobs and assignments
  * All cloud storage connections
  * All member associations
</Warning>

Only the Owner can delete an organization:

<Steps>
  <Step title="Open Organization Page">
    Navigate to the organization settings
  </Step>

  <Step title="Select Remove">
    Click **Actions** > **Remove organization** in the top-right corner
  </Step>

  <Step title="Confirm Deletion">
    Enter the organization's short name to confirm
    Click **Remove**
  </Step>
</Steps>

<Tip>
  Before deleting an organization, export any important data or annotations you want to keep.
</Tip>

## API Access

Organizations can be managed via the REST API:

```bash theme={null}
# List organizations
GET /api/organizations

# Create organization
POST /api/organizations

# Get organization details
GET /api/organizations/{id}

# Update organization
PATCH /api/organizations/{id}

# Delete organization
DELETE /api/organizations/{id}

# List members
GET /api/memberships?org={org_id}

# Create invitation
POST /api/invitations
```

See [API Documentation](/api/organizations) for complete reference.

## Best Practices

<CardGroup cols={2}>
  <Card title="Clear Naming" icon="tag">
    Use descriptive organization names that reflect your team or project.
  </Card>

  <Card title="Role Assignment" icon="user-gear">
    Assign roles based on actual responsibilities and follow the principle of least privilege.
  </Card>

  <Card title="Regular Reviews" icon="calendar-check">
    Periodically review member list and remove inactive members.
  </Card>

  <Card title="Documentation" icon="book">
    Document your organization's workflow and role expectations.
  </Card>
</CardGroup>

## Common Use Cases

### Small Annotation Team

* 1 Owner (team lead)
* 1-2 Supervisors (project managers)
* Multiple Workers (annotators)

### Large Enterprise

* 1 Owner (organization administrator)
* Multiple Maintainers (department leads)
* Multiple Supervisors (project managers)
* Many Workers (annotation teams)

### Research Lab

* 1 Owner (principal investigator)
* Maintainers (senior researchers)
* Supervisors (PhD students managing datasets)
* Workers (annotators and research assistants)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't see organization resources">
    Make sure you've switched to the correct organization from the organization menu. The active organization should have a checkmark.
  </Accordion>

  <Accordion title="Invitation email not received">
    Check spam folder. Organization Owners/Maintainers can resend invitations from the Invitations page.
  </Accordion>

  <Accordion title="Can't invite members">
    Only Owners and Maintainers can invite members. Check your role on the Organization page.
  </Accordion>

  <Accordion title="Can't change a member's role">
    Maintainers cannot change Owner or other Maintainer roles. Only the Owner can modify Maintainer roles.
  </Accordion>
</AccordionGroup>

## Related Resources

* [User Roles](/account/user-roles) - Understand organization roles and permissions
* [Subscription Plans](/account/subscription-plans) - Learn about Team plan pricing
* [Creating Projects](/projects/creating-projects) - Create projects within organizations
* [REST API](/api/organizations) - Manage organizations programmatically