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

# Managing Your Team

> Update permissions and remove collaborators

## Overview

As your project evolves, you may need to adjust who has access and what they can do. This guide covers managing your existing team.

## Viewing Your Team

To see all collaborators on a project:

1. Open your project
2. Go to **Settings**
3. Scroll to the **Collaborators** section

You'll see two lists:

* **Active Collaborators** - People with current access
* **Pending Invitations** - Invitations not yet accepted

## Collaborator Information

For each active collaborator, you can see:

| Field          | Description              |
| -------------- | ------------------------ |
| **Avatar**     | Profile picture          |
| **Name**       | Display name             |
| **Email**      | Email address            |
| **Permission** | Current access level     |
| **Actions**    | Update or remove options |

## Updating Permissions

To change a collaborator's permission level:

<Steps>
  <Step title="Find the Collaborator">
    Locate them in the Active Collaborators list
  </Step>

  <Step title="Click Permission Dropdown">
    Click on their current permission level
  </Step>

  <Step title="Select New Permission">
    Choose either **Read Only** or **Read & Write**
  </Step>

  <Step title="Confirm">
    The change takes effect immediately
  </Step>
</Steps>

<Note>
  Only project owners can change permissions. If you're a collaborator, you'll see permissions as read-only badges.
</Note>

### When to Upgrade Permissions

Consider upgrading from Read Only to Read & Write when:

* Someone needs to contribute code
* A reviewer becomes an active developer
* Project scope expands for a team member

### When to Downgrade Permissions

Consider downgrading from Read & Write to Read Only when:

* Someone's role changes to review-only
* Reducing access for security reasons
* Temporary restriction during sensitive periods

## Removing Collaborators

To remove someone's access completely:

<Steps>
  <Step title="Find the Collaborator">
    Locate them in the Active Collaborators list
  </Step>

  <Step title="Click Remove">
    Click the remove/trash icon next to their entry
  </Step>

  <Step title="Confirm Removal">
    Confirm when prompted
  </Step>
</Steps>

<Warning>
  Removal is immediate. The person will no longer see the project on their dashboard and cannot access any project data.
</Warning>

### What Happens When You Remove Someone

* They lose all access immediately
* The project disappears from their dashboard
* Their past commits remain in the project
* They cannot view, pull, or push
* They can be re-invited later if needed

## Managing Pending Invitations

For invitations that haven't been accepted:

### Resend an Invitation

If someone didn't receive or lost the email:

1. Find the pending invitation
2. Click **Resend**
3. A new email is sent

### Revoke an Invitation

If you no longer want to invite someone:

1. Find the pending invitation
2. Click **Revoke**
3. The invitation link becomes invalid

## Bulk Management

For larger teams, consider these strategies:

1. **Regular reviews** - Schedule monthly permission audits
2. **Documentation** - Keep a record of who should have access
3. **Onboarding checklist** - Standard permissions for new team members
4. **Offboarding process** - Always remove access when people leave

## Team Size Limits

VibeHub Hobby tier may have limits on team size. Check your plan for:

* Maximum collaborators per project
* Total collaborators across all projects

## Troubleshooting

### Can't Remove a Collaborator

* Make sure you're the project owner
* Check that you're not trying to remove yourself
* Refresh the page and try again

### Permission Change Not Working

* Verify you have owner access
* Check your network connection
* The change should be immediate - no save button needed

### Collaborator Can't Access Project

* Verify their invitation was accepted
* Check they're using the correct email account
* Confirm the project visibility settings

## Best Practices

<AccordionGroup>
  <Accordion title="Regular Audits" icon="clipboard-check">
    Review your collaborator list monthly. Remove anyone who no longer needs access.
  </Accordion>

  <Accordion title="Document Access" icon="file-lines">
    Keep a simple record of who has access and why, especially for sensitive projects.
  </Accordion>

  <Accordion title="Prompt Offboarding" icon="user-minus">
    When someone leaves the team or project, remove their access immediately.
  </Accordion>

  <Accordion title="Least Privilege" icon="shield">
    Default to Read Only access and upgrade only when needed.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Invite More Collaborators" icon="user-plus" href="/collaboration/inviting-collaborators">
    Add new team members
  </Card>

  <Card title="Project Settings" icon="gear" href="/projects/project-settings">
    Configure other project options
  </Card>
</CardGroup>