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

# Project Members & Roles

> Manage DevTune project access through team membership, including how shared team-account access works, role permissions, and inviting new members.

DevTune projects are shared within teams. This guide covers how access works, what each role can do, and how to manage your team.

## How Project Access Works

Projects belong to **team accounts**, not individual users. This means:

* Everyone on the team can access all projects in that team
* Access is controlled at the team level, not the project level
* Member permissions apply across all projects in the team

> **Note:** If you need different access for different projects, consider creating separate team accounts for different groups.

## Team Roles

DevTune has two role levels:

### Owner

The team **Owner** has full control:

* Create and delete projects
* Manage billing and subscriptions
* Invite and remove team members
* Change member roles
* Access all settings
* View all results and analytics

Each team has one primary owner. Ownership can be transferred to another team member if needed.

### Member

**Members** have broad access to use DevTune features:

* View all projects
* View results and analytics
* Manage project settings (settings.manage permission)
* Invite new team members (invites.manage permission)
* Create and edit configurations

Members cannot:

* Manage billing
* Remove other team members
* Change member roles
* Delete the team account

## Role Permissions Summary

| Permission                        | Owner | Member |
| --------------------------------- | ----- | ------ |
| View projects                     | Yes   | Yes    |
| View results and analytics        | Yes   | Yes    |
| Manage settings (settings.manage) | Yes   | Yes    |
| Invite members (invites.manage)   | Yes   | Yes    |
| Manage roles (roles.manage)       | Yes   | No     |
| Manage billing (billing.manage)   | Yes   | No     |
| Remove members (members.manage)   | Yes   | No     |
| Delete team                       | Yes   | No     |
| Transfer ownership                | Yes   | No     |

## Managing Team Members

### Viewing Current Members

To see who is on your team:

1. Go to your team account page
2. Navigate to the **Members** tab
3. View all current members and their roles

### Inviting New Members

Both Owners and Members can invite new people to the team:

1. Go to the team page and select the **Members** tab
2. Click **Invite Member**
3. Enter their email address
4. Select a role -- Owners see a role dropdown and can assign either Owner or Member; Members can only invite as Member (no role selection shown)
5. Send the invitation

The invitee receives an email with instructions to join. There is a limit of **5 pending invitations** at a time. Invitations expire after a set period.

### Auto-Join by Domain

Owners can configure a domain for automatic team joining:

1. Go to team settings
2. Set the **Auto-Join Domain** (e.g., "acme.com")
3. Users who sign up with an email address matching that domain are automatically added to the team

This is useful for organizations where all employees share a common email domain.

### Changing Member Roles

To change someone's role (Owner only):

1. Go to the Members tab
2. Find the member in the list
3. Click the role dropdown
4. Select the new role
5. Confirm the change

> **Note:** Only Owners can change roles. You cannot change your own role or assign a role higher than your own.

### Removing Members

To remove someone from the team (Owner only):

1. Go to the Members tab
2. Find the member to remove
3. Click the remove option
4. Confirm the removal

Removed members:

* Immediately lose access to all projects
* Cannot see any team data
* Must be re-invited to regain access

## Leaving a Team

If you want to leave a team yourself:

1. Go to the team settings
2. Find the **Leave Team** option
3. Confirm your departure

> **Note:** The primary Owner cannot leave without transferring ownership first.

## Multiple Teams

You can be a member of multiple teams:

* Each team has its own projects
* Switch between teams using the team selector in the header
* Your role may be different in each team

## Best Practices

### Role Assignment

* **Owners** - Typically the team lead or billing contact
* **Members** - Day-to-day users who work with projects and results

### Onboarding New Members

When adding new team members:

1. Invite them with the appropriate role
2. Point them to the project documentation
3. Walk them through your project structure
4. Explain your tracking workflows

### Offboarding Members

When someone leaves:

1. Remove them from the team promptly (Owner action)
2. Review any configurations they created
3. Update any shared credentials if applicable

## Next Steps

* **[Team Management](/account-billing/team-management)** - More details on team administration
* **[Account Settings](/account-billing/account-settings)** - Configure your personal account