# User Management
Add, remove, and manage users in your Vrex workspace
Manage who can access your Vrex workspace and what they can do.

## Workspace Roles

| Role | Permissions |
|------|-------------|
| **Owner** | Full control, billing, can delete workspace |
| **Admin** | Manage users, projects, settings |
| **Member** | Access projects they're assigned to |
| **Guest** | Limited access to specific projects |

## Adding Users

### Invite by Email

1. Go to **Workspace Settings** → **Users**
2. Click **Invite User**
3. Enter their email address
4. Select their role
5. Click **Send Invite**

The user receives an email with a link to join your workspace.

### Bulk Invite

For multiple users:

1. Click **Bulk Invite**
2. Paste email addresses (one per line)
3. Select the role for all invitees
4. Click **Send Invites**

### SSO Provisioning

If SSO is configured, users are automatically added when they:
1. Log in with your identity provider
2. Are assigned to the Vrex application in your IdP

See [SSO Configuration](/v2/admin/sso/) for setup.

## Managing Existing Users

### Change Role

1. Find the user in the user list
2. Click the **role dropdown**
3. Select the new role
4. Change takes effect immediately

### Remove User

1. Find the user in the user list
2. Click the **menu icon** (⋮)
3. Select **Remove from workspace**
4. Confirm removal

Removed users lose access to all projects in the workspace.

### Suspend User

Temporarily disable access without removing:

1. Click the menu icon
2. Select **Suspend**
3. User cannot log in until reactivated

Useful for: Contractors between engagements, employees on leave.

## User Details

Click a user to view:
- Email and login method
- Role and permissions
- Last active date
- Projects they can access
- Sessions they've joined

## Groups

Organize users into groups for easier management.

### Create a Group

1. Go to **Users** → **Groups**
2. Click **New Group**
3. Name the group (e.g., "Design Team", "External Consultants")
4. Add users to the group

### Assign Projects to Groups

Instead of adding users individually to each project:

1. Open project settings
2. Go to **Team**
3. Click **Add Group**
4. Select the group
5. Choose permission level

All group members get access.

## Activity Log

Track user actions:

1. Go to **Settings** → **Activity Log**
2. Filter by user, action type, or date
3. Export for compliance reporting

Logged actions include:
- Login/logout
- Project access
- Model uploads
- Session participation

## User Limits

| Plan | User Limit |
|------|------------|
| Starter | 5 users |
| Professional | 25 users |
| Enterprise | Unlimited |

Contact sales@vrex.no to adjust limits.

## Self-Service

Allow users to manage their own:

- Profile (name, avatar)
- Notification preferences
- Password (if not using SSO)

Admins control what users can self-manage in workspace settings.

## External Guests

For users outside your organization:

1. Use **Invite Guest** instead of Invite User
2. Guests create a free Vrex account
3. Access is limited to projects you assign
4. Guests don't count toward user limits on some plans

## Offboarding

When someone leaves your organization:

1. Remove them from the Vrex workspace
2. Or let SSO deprovisioning handle it automatically
3. Transfer ownership of projects they owned
4. Review and reassign any open issues