Skip to main content
Organizations enable teams to collaborate on annotation projects by sharing resources, managing members, and controlling access to tasks and datasets.
An organization acts as a shared workspace where multiple users can work together with role-based permissions.

​
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 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
  • Team subscription benefits apply to all members
  • Centralized management and billing

​
Creating an Organization

To create a new organization:
1

Access Organization Menu

Click your username in the top menu, then select Organization > + Create
2

Fill Organization Details

Complete the organization creation form:
FieldRequiredDescription
Short nameYesSlug used in URLs and displayed in menus (max 16 chars)
Full nameNoComplete organization name
DescriptionNoOrganization purpose and details
EmailNoOrganization contact email
Phone numberNoOrganization contact phone
LocationNoOrganization address
3

Submit

Click Submit to create the organization
You are automatically assigned the Owner role when you create an organization.
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
The currently active workspace is marked with a checkmark and displayed under your username.

​
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:
1

Activate Organization

Switch to the organization you want to manage
2

Open Settings

Click Username > Organization > Settings
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

Only Owners and Maintainers can invite new members to an organization.
To invite members:
1

Open Invite Form

Go to the Organization page and click Invite members
2

Enter Member Details

Fill in the invitation form:
  • Email: The email address of the user to invite
  • Role: Select Worker, Supervisor, or Maintainer
3

Send Invitation

Click OK to send the invitation email
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
You can invite multiple users at once by clicking Invite more in the form.
Code Reference: Invitation model in cvat/apps/organizations/models.py:66-116

​
Member Roles

When inviting members, you can assign these roles:

Worker

Access only to assigned tasks and jobs. Best for annotators and validators.

Supervisor

Can create and assign tasks. Best for project managers.

Maintainer

Full administrative access except deleting organization. Best for team leads.

Owner

Full control including organization deletion. Automatically assigned to creator.
See 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
  • Maintainers cannot change Owner or other Maintainer roles
  • The Owner role cannot be transferred (this is a future feature)
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
The Owner cannot leave or be removed from an organization. To transfer ownership, you must first delete and recreate the organization.

​
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
Invitations expire after the number of days configured in ORG_INVITATION_EXPIRY_DAYS (default in source code).

​
Transferring Resources

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

Open Actions Menu

Find the project or task you want to transfer Click the Actions menu (three dots)
2

Select Organization

Choose Organization from the menu Select the destination workspace
3

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
4

Complete Transfer

Click Move to complete the transfer
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)

​
Organization Data Model

Understanding the organization structure: 
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

Organization subscriptions work differently from personal subscriptions. See Subscription Plans for details.
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

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
Only the Owner can delete an organization:
1

Open Organization Page

Navigate to the organization settings
2

Select Remove

Click Actions > Remove organization in the top-right corner
3

Confirm Deletion

Enter the organization’s short name to confirm Click Remove
Before deleting an organization, export any important data or annotations you want to keep.

​
API Access

Organizations can be managed via the REST API: 
# 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 for complete reference.

​
Best Practices

Clear Naming

Use descriptive organization names that reflect your team or project.

Role Assignment

Assign roles based on actual responsibilities and follow the principle of least privilege.

Regular Reviews

Periodically review member list and remove inactive members.

Documentation

Document your organization’s workflow and role expectations.

​
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

Make sure you’ve switched to the correct organization from the organization menu. The active organization should have a checkmark.
Check spam folder. Organization Owners/Maintainers can resend invitations from the Invitations page.
Only Owners and Maintainers can invite members. Check your role on the Organization page.
Maintainers cannot change Owner or other Maintainer roles. Only the Owner can modify Maintainer roles.

Build docs developers (and LLMs) love

Get started for freeTalk to us