Skip to main content

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.

Steven Silverstone
Updated by Steven Silverstone

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.

If you previously used People & Teams, it has been renamed to Users & Teams with expanded filtering and visibility.

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:

  1. Go to Settings → Users & Teams → Users.
  2. Click Add User.
  3. Enter name, email, and role.
  4. Define team scope and membership.
  5. 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.

  1. Click the ⋮ menu next to a user.
  2. Select Merge Account.
  3. Choose the duplicate account.
  4. Confirm the merge.
Cross-platform merges are supported, allowing Git, PM, and platform identities to be unified under a single user.

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
Admin permissions are required.

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

  1. Go to Settings → Users & Teams → Users.
  2. Locate the user you want to remove.
  3. Click the menu at the end of the row.
  4. Select Delete User.
  5. 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

  1. From Settings → Users & Teams → Users, click Show deleted users.
  2. Use search and filters as needed to locate the deleted account.

Restore a deleted user

  1. In the deleted users list, locate the user you want to restore.
  2. Click the menu at the end of the row.
  3. Select Restore User.
If you don’t see Delete User or Restore User, check your permissions or your organization’s authentication setup.

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

Contact