Migrating to the New Unified User Management UI
Understand what changes in the new User Management experience and follow the steps to transition your org without losing control or visibility.
LinearB has introduced a unified User Management interface that streamlines how admins view, manage, and edit users and teams. This migration consolidates previously separate settings into a single, simplified experience.
Summary
- User and team management is now centralized under Settings → Users & Teams.
- The former Contributors table is now a unified Users table.
- User invitations, merging, filtering, and billing visibility are handled in one place.
- New filters and a status line replace legacy Git and team-based filters.
- Admins can also delete users and restore deleted users from the same area.
What’s changing
The new UI introduces the following updates:
| Feature | Previous UI | New UI |
| Navigation | Users under Settings | Users moved to Users & Teams |
| Tab name | People & Teams | Users & Teams |
| User list | Contributors table | Users table |
| Filtering | Git connection + In team | Status line + Billable Users |
| User invitation | Invite User flow | Add User workflow |
| User merge | Manual per profile | Merge Account from user list |
| Billable seats | Limited billing view | Billable Users filter (rolling out) |
Unified access: Users & Teams
All user management is now centralized under Settings → Users & Teams. You no longer manage users separately from teams—contributors, integrations, and seats are all visible in the unified Users table.
Updated Users table
The renamed Users table now includes:
- Role-based permissions (Admin, Editor, Viewer)
- Git and project management connections
- Team membership and scope
- Inline profile editing and merge actions
Adding users
Instead of the legacy invitation flow, admins now add users directly:
- Go to Settings → Users & Teams → Users.
- Click Add User.
- Enter name, email, and role.
- Define team scope and membership.
- Click Save and Close.
Merging users
The Merge Account action is now available directly from the user list, enabling faster cleanup of duplicate or platform-linked users.
- Click the ⋮ menu next to a user.
- Select Merge Account.
- Choose the duplicate account.
- Confirm the merge.
Primary user behavior in merged accounts
When users are merged in the unified User Management UI, one account is designated as the primary user.
Primary user selection
- The primary user is the account selected when opening the merge screen.
- The primary user becomes the authoritative identity after the merge.
- In a future update, admins will be able to change the primary user during the merge process.
Identity and visibility
- The primary user’s details (name, email, avatar, and permissions) are shown throughout the platform.
- This includes teams, dashboards, metrics, alerts, and pull request ownership.
Team memberships
- The merged user becomes a member of all teams associated with any of the merged accounts.
-
Example:
- User A belongs to Team 1
- User B belongs to Team 2
- The merged user belongs to Team 1 and Team 2
Permissions
- The merged user inherits only the permissions of the primary user.
- Secondary accounts are retained behind the scenes for data continuity with basic permissions.
- Permissions are not combined across merged accounts.
Platform users
As part of the unified User Management experience, LinearB now treats each person as a platform user.
A platform user represents a single, unified identity in LinearB, even if that person was previously represented by multiple accounts due to different emails, integrations, or login methods.
Merging users ensures:
- A single identity across all LinearB features
- Preservation of historical activity and metrics
- Consistent team membership and permissions
SSO and user merging (TBD)
For organizations using Single Sign-On (SSO), additional considerations may apply when users authenticate for the first time or when identities are created automatically.
TBD:
- Whether new platform users can be created automatically on first SSO login
- When merging is required or recommended for SSO-managed users
- Best practices for avoiding duplicate users in SSO environments
This section will be updated once SSO behavior is fully confirmed.
Deleting and restoring users
In the unified Users table, admins can delete users and later restore them from the Deleted Users list. This is useful when access needs to be removed quickly, while still keeping a path to re-enable the account later.
Delete a user
- Go to Settings → Users & Teams → Users.
- Locate the user you want to remove.
- Click the ⋮ menu at the end of the row.
- Select Delete User.
- Review the confirmation dialog, then click Delete User.
Deleting a user will:
- Remove them from all teams
- Exclude them from reports and metrics
- Hide them from all Settings pages
View deleted users
- From Settings → Users & Teams → Users, click Show deleted users.
- Use search and filters as needed to locate the deleted account.
Restore a deleted user
- In the deleted users list, locate the user you want to restore.
- Click the ⋮ menu at the end of the row.
- Select Restore User.
Filtering and status line
Legacy filters have been replaced with a modern Status Line and Billable Users filter.
- Filter by Active, Inactive, or Hidden users.
- Identify billable vs non-billable users.
Billable seats (rolling out)
Visibility into billable seats is moving into the unified Users table. When available, admins will be able to:
- Filter to view only billable users
- Export user lists for audits
- Identify inactive users consuming seats
Before vs after: task comparison
| Task | Previous UI | New UI |
| Add user | Invite User | Add User |
| Merge users | Profile merge | Users list → Merge Account |
| Delete user | Varied by setup | Users list → Delete User (and Restore User from deleted users) |
| View billable seats | Separate billing view | Billable Users filter |
| Filter users | Git + Team | Status line + Billable filter |
How did we do?
Managing Users in the Users & Teams – Users Tab
Understanding Users and Contributors in LinearB