Organization management

Managing your organization, its members, and repositories

In Diversion, an organization is a group of users who share repositories, making it easier to collaborate and manage projects. You can find your organizations under Your organizations in the user menu.

Creating an organization

You can only create one organization per account, but you can be a member of many organizations.

Creating your first organization

If you don’t own or belong to any organization:

1. Click on your avatar in the top navigation and select Create organization.

   

2. Choose a name for your organization and click Create organization.

   

If you already belong to one or more organizations:

1. Go to Your organizations page from your profile:

   

2. Click on the Select organization dropdown in the top right corner and select + Create New Organization.

   

3. Choose a name for your organization and click Create organization.

Creating an organization while creating a repository

Alternatively, you can create an organization while creating a new repository:

1. When creating a new repository, click the Parent organization dropdown and select + Create New Organization.
2. Enter your organization name to create both the repository and organization simultaneously.

Note: As an organization owner, you are responsible for all billing, including storage usage and organization member seats. When you upgrade to a paid tier, an organization may be created automatically for you depending on your tier (Indie/Educational/Professional).

Managing an organization

Each organization has an owner. The owner can invite other users to join the organization. When you add a user to your organization, they won’t have access to all of your repositories and you can still manage access on a per-repo basis.

When inviting a user, the owner can decide if the user should have admin privileges. Admins can also manage users, same as the owner.

The difference between the owner and an admin is that billing for the organization is managed through the owner’s Diversion account.

If you send an invite to someone who doesn’t have a Diversion account, they will be prompted to create one.

Removing users

The owner or admins can also remove users from the organization. When removing a user, you’ll be prompted with the list of repositories the user can access. These are all of the repositories that the user will no longer have access to.

This means that the Diversion agent will no longer sync these repositories with the user’s workspace. This also means that the user will keep stale copies of the repositories that were previously cloned locally.

Removing a user that owns repositories is currently not supported through the app. You’ll have to contact support to transfer ownership of those repositories before removing the user.

Working in an organization

When you’re a member of an organization and you create a new repository, it will be automatically assigned to your organization. This ensures that all repositories are properly organized and accessible to the relevant team members.

Other than that, working as part of an organization is exactly the same as working as an individual user.

Organization repository management

Organization owners and admins can view and manage all repositories associated with the organization, including repositories they are not personally collaborating on. This includes managing collaborators and transferring ownership.

Viewing organization repositories

1. Navigate to your organization

   Click on your avatar in the top navigation and select Your organizations.

   
2. Open the Repositories page

   In the left sidebar, click Repositories to view all repositories in the organization.

   
3. Browse organization repositories

   You will see a table listing all repositories in the organization, including their name, creation date, size, auto-update status, and collaborators. As an organization owner or admin, you can see repositories that you are not personally collaborating on.

   

If you belong to multiple organizations, use the Select organization dropdown in the top right corner to switch between organizations.

Managing repository collaborators

Organization owners and admins can manage collaborators for any repository in the organization, even if they are not a collaborator on that repository themselves.

1. Navigate to the Repositories page

   Go to your organization’s Repositories page as described above.

2. Open the repository actions menu

   Find the desired repository in the table and click the menu icon on the right side.

   
3. Select 'Manage Collaborators'

   Click Manage Collaborators to open the collaborators dialog.

   
4. Add or remove collaborators

   From the collaborators dialog, you can:

   • View all current collaborators and their permission levels
   • Invite new collaborators by entering their email address and selecting an access level
   • Change a collaborator’s permission level
   • Remove a collaborator from the repository
   • Add yourself to the repository by entering your own email address — even if you’re not currently a collaborator on that repo

Transferring repository ownership

You can transfer repository ownership to another member of the organization. The user performing the transfer must be both the repository owner and an organization admin or owner.

1. Navigate to the Repositories page

   Go to the Repositories page in your organization page (accessible from the left sidebar).

   
2. Open the transfer dialog

   Find the desired repository. Click on the menu icon on the right side and select Transfer ownership.

   
3. Select the new owner

   Choose the member you wish to transfer ownership to from the dropdown and confirm the transfer.

This action cannot be undone. The new owner will have full control over the repository, and you will lose ownership privileges.

Leaving an organization

Only non-owner members can leave an organization. Select the organization you wish to leave from the dropdown menu “Select organization” in the top right corner of the screen and click “Leave organization”.

Note: Leaving an organization will result in losing access to all repositories associated with it. You can always be invited back to the organization later.

If you own one or more repositories that are associated with the organization, you won’t be able to leave the organization. You must either transfer the repository ownership to another member of the organization or delete the repositories first.

Organization deletion

Deleting an organization is not possible. If you no longer need an organization, you can remove all members and repositories from it.

FAQs

What happens to my repositories if I’m a member of multiple organizations?

If you’re a member of multiple organizations, when you create a new repository, it won’t be automatically assigned to any repo. Right now, if you want to assign a repository to an organization, you’ll have to contact support.

How do I transfer organization ownership to another user?

Ownership transfer is currently handled by our support team. If you’re an organization owner and want to transfer ownership:

1. Ensure the new owner is already a member of your organization. If not, invite them first as explained above.
2. Email our support team with your request, including the new owner’s email address, and our team will complete the transfer.
3. The new owner should select their desired tier, storage capacity, and seats, then add a payment method to avoid subscription breach system messages.
4. Once the new owner has set up their subscription, cancel your old subscription from Plan & Billing to avoid double payment.

How do I become the owner of an organization I am a member of?

Ask your organization owner to contact our support team and request the ownership transfer to your account. The owner should follow the steps outlined in the question above.

Why am I receiving system messages about exceeding my user limit?

If you’re seeing system messages like this:

This means your organization has more members than your current plan allows. To resolve this, you have two options:

1. Upgrade your plan - Purchase additional user seats to accommodate your current team size.
2. Remove users from your organization - See the removing users section above for step-by-step instructions.

If you’re seeing system messages like this:

This means you haven’t selected a plan yet. To resolve this:

Select a plan - See choosing your plan for guidance, or visit our pricing page to view available options.

How do I move repositories out of my organization?

If there are repositories in your organization that you don’t own or collaborate on, contact our support team. They will help you migrate these repositories to the appropriate owner’s organization.

How do I move my repositories from another organization to my own?

If you own repositories in someone else’s organization and want to move them to your own organization, ask the current organization owner to contact our support team and request the repository transfer.