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

# Manage project access

> Manage repo collaborators: add, remove, and leave repositories

## Add people to your project

You have a project set up, and want to add your team members? Here's how:

<Steps>
  <Step title="Open the repository's menu and select 'Collaborators'">
    Open the repository's **...** menu - in its row on either the **Local Workspaces** or **Remote Repositories** tab of the dashboard, or from the open repository's actions menu - and select **Collaborators**.

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/add-collabs-click-repo-menu.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=743c2587cb0a7432cc60f6737b5c3022" alt="Open the repo menu" width="1860" height="540" data-path="images/add-collabs-click-repo-menu.png" />

    If you don't have a repo yet, [create one first](/basic/start-using-diversion).
  </Step>

  <Step title="Enter the email">
    Also choose the access level you want to grant. Admins can invite other members.

    <img src="https://mintcdn.com/diversion-2/TpH-kQnsH_KxwztQ/images/add-collabs-enter-email.png?fit=max&auto=format&n=TpH-kQnsH_KxwztQ&q=85&s=cad99fe0bdb0032fc786178903fb6ddd" alt="Enter email" width="1545" height="525" data-path="images/add-collabs-enter-email.png" />
  </Step>

  <Step title="Click `Invite`" />
</Steps>

That's it! Your team members will receive invitation emails to join the project. If they don't have Diversion installed yet, they'll be prompted to do so.
They can accept the invitation and start working with you. The repo appears on the **Remote Repositories** tab in the app -- they open its `...` menu and select `Clone repo` to get started. If they need any help, [send them here](/basic/get-existing-project).

## Remove people from your project

<Steps>
  <Step title="Open the repository's menu and select 'Collaborators'">
    Open the repository's **...** menu - in its row on either the **Local Workspaces** or **Remote Repositories** tab of the dashboard, or from the open repository's actions menu - and select **Collaborators**.

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/add-collabs-click-repo-menu.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=743c2587cb0a7432cc60f6737b5c3022" alt="Open the repo menu" width="1860" height="540" data-path="images/add-collabs-click-repo-menu.png" />
  </Step>

  <Step title="Select the member you wish to remove">
    Click on the user's permission level and select **Delete**.

    <img src="https://mintcdn.com/diversion-2/ipasz3EJ2O9WM2Qx/images/remove-collabs-click-delete.png?fit=max&auto=format&n=ipasz3EJ2O9WM2Qx&q=85&s=f4c08d74d9b4422259e4362d728ba465" alt="Remove user from repo" width="1532" height="507" data-path="images/remove-collabs-click-delete.png" />

    <Note>
      Only repo owners and admins can remove members. The repo owner cannot be removed.
    </Note>
  </Step>

  <Step title="Confirm the removal">
    Review and confirm your action.

    <img src="https://mintcdn.com/diversion-2/TpH-kQnsH_KxwztQ/images/confirm-removal-from-repo.png?fit=max&auto=format&n=TpH-kQnsH_KxwztQ&q=85&s=ae0de7c7c6bbc05ef736824ec9803b2b" alt="Confirm removal of a user from repo" width="673" height="355" data-path="images/confirm-removal-from-repo.png" />
  </Step>
</Steps>

<Info>
  **Good to know:**

  * Removing a member from a repo doesn't remove them from the organization (if applicable)
  * You can re-invite removed members at any time
  * Removed members will immediately lose access to the repo and its contents
  * Their local files on disk are not deleted
</Info>

## Leave a repository

<Info>
  **Good to know:**

  * Leaving a repo doesn't remove you from the organization (if applicable)
  * You can be re-invited at any time
  * You will immediately lose access to the repo and its contents upon leaving
  * Your local files on disk are not deleted
  * You cannot leave a repo you own
</Info>

There are two ways to leave a repository:

### Option 1: From the repository's collaborators dialog

<Steps>
  <Step title="Open the repository's menu and select 'Collaborators'">
    Open the repository's **...** menu - in its row on either the **Local Workspaces** or **Remote Repositories** tab of the dashboard, or from the open repository's actions menu - and select **Collaborators**.

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/add-collabs-click-repo-menu.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=743c2587cb0a7432cc60f6737b5c3022" alt="Open the repo menu" width="1860" height="540" data-path="images/add-collabs-click-repo-menu.png" />
  </Step>

  <Step title="Select yourself">
    Click on your permission level and select **Delete**.

    <img src="https://mintcdn.com/diversion-2/ipasz3EJ2O9WM2Qx/images/remove-collabs-click-delete.png?fit=max&auto=format&n=ipasz3EJ2O9WM2Qx&q=85&s=f4c08d74d9b4422259e4362d728ba465" alt="Remove user from repo" width="1532" height="507" data-path="images/remove-collabs-click-delete.png" />
  </Step>

  <Step title="Confirm leaving the repository">
    <img src="https://mintcdn.com/diversion-2/1gtJGlFCNWbOCiCM/images/leave-repo-confirm.png?fit=max&auto=format&n=1gtJGlFCNWbOCiCM&q=85&s=07607a8ad8817375083c50f62473168c" alt="Confirm leaving a repo" width="665" height="340" data-path="images/leave-repo-confirm.png" />
  </Step>
</Steps>

### Option 2: From the remote repo

<Steps>
  <Step title="Open the repo's menu and select 'Leave repository'">
    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/leave-repo-from-remote-repo.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=6ea133d83a47ffc1a19cf6b6bf730b51" alt="Leave repo from the remote repo" width="1860" height="474" data-path="images/leave-repo-from-remote-repo.png" />
  </Step>

  <Step title="Confirm leaving the repository">
    Review and confirm your action.

    <img src="https://mintcdn.com/diversion-2/1gtJGlFCNWbOCiCM/images/leave-repo-confirm.png?fit=max&auto=format&n=1gtJGlFCNWbOCiCM&q=85&s=07607a8ad8817375083c50f62473168c" alt="Confirm leaving a repo" width="665" height="340" data-path="images/leave-repo-confirm.png" />
  </Step>
</Steps>

## Transfer repository ownership

To transfer repository ownership, the repository must be associated with an organization. For detailed instructions, see [transferring repository ownership](/basic/organization-management#transferring-repository-ownership) within the same organization, or [transferring a repository to another organization](/basic/organization-management#transferring-a-repository-to-another-organization) across organizations.

## FAQs

### Why am I receiving system messages about exceeding my user limit when my repository has fewer users?

If you're seeing [system messages](/system-messages) like this:

<img src="https://mintcdn.com/diversion-2/LPmIgUcQRdTQ4EIi/images/Notifications/user-plan-notification.png?fit=max&auto=format&n=LPmIgUcQRdTQ4EIi&q=85&s=51d4774013d759a674bf55fb0ce86df5" alt="User Plan Limit Notification" width="980" height="40" data-path="images/Notifications/user-plan-notification.png" />

Even after removing excess users from all your repositories, check your organization members. The excess users may still be part of your organization and need to be removed there as well. See [removing users from your organization](/basic/organization-management#removing-users) for detailed instructions.
