Migrating to the New Unified User Management UI

LinearB has introduced a unified user management interface that streamlines how admins view, manage, and edit users and teams. User and team administration is now centralized under Settings → Users & Teams, with modern filtering, editing, and merging workflows.

Summary

• User and team management is 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.
• Admins can delete users and restore deleted users from the same area.
• User merges now include selecting a Primary Account for the unified identity.

---

What’s changing

The new UI introduces the following updates:

Feature	Previous UI	New UI
Navigation	Users under Settings / legacy People views	Users moved to Settings → Users & Teams → Users
Tab name	People & Teams	Users & Teams
User list	Contributors table	Users table
Connections	Git Connection + PM Connection columns	Single Connections column
Filtering	Legacy Git/team filters	Add Filter menu (role, membership, connections, billable)
User invitation	Invite User flow	Add User workflow
User merge	Manual per profile	Merge Account from the user list, with Primary Account selection
Billable seats	Limited billing view	Billable Users filter (where enabled)

---

Unified access: Users & Teams

All user management is centralized under Settings → Users & Teams. The unified Users table brings permissions, team membership, and external connections into one place.

---

Updated Users table

The Users table includes:

• Role-based permissions (Admin, Editor, Viewer)
• Team membership and scope
• A consolidated Connections column for Git and project management tools
• Inline actions for editing, merging, and deleting users
• Column controls via Edit Columns

---

Adding users

How to add users

1. Go to Settings → Users & Teams → Users.
2. Click Add User.
3. Enter Full name, Email, and User role.
4. Optionally define Team scope and Team membership.
5. Click Save & Close.

---

Merging users

How to merge users

The Merge Account action is available from the user list to help clean up duplicate or platform-linked identities.

1. Click the ⋮ menu next to a user.
2. Select Merge Account.
3. Select the additional account(s) that represent the same person.
4. Select the Primary Account.
5. Save the merge.

Cross-platform merges are supported, allowing Git, project management, and platform identities to be unified under one user.

---

Primary account behavior in merged accounts

During a merge, you must select a Primary Account. This determines the authoritative identity used across LinearB.

Primary account selection

• The primary account becomes the authoritative identity after the merge.
• The primary account’s name, email, avatar, and permissions are used throughout the platform.
• Permissions are inherited only from the primary account (they are not combined).

Team memberships

• The merged user becomes a member of all teams associated with any merged account.

---

Platform users

LinearB treats each person as a single platform user, even if they were previously represented by multiple accounts due to different emails, integrations, or login methods.

Merging users helps ensure:

• A single identity across all LinearB features
• Preservation of historical activity and metrics
• Consistent permissions and team membership

---

Deleting and restoring users

Admin permissions are required.

Admins can delete users and later restore them from the deleted users list. This is useful when access needs to be removed while 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. Confirm the action.

View deleted users

1. From Settings → Users & Teams → Users, click Show deleted users.
2. Use search and filters 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.

Billing note

• A user is billable only if they are assigned to a team and have a Git account connected.
• Users without a Git connection are not counted as billable.

---

Filtering and table controls

Legacy filters have been replaced with a unified filtering and table configuration experience.

• Use Add Filter to filter by role, membership, connections, or billable users.
• Use Edit Columns to show or hide columns in the table.
• Use Rows per page and paging controls to navigate large user lists.

---

Before vs after: task comparison

Task	Previous UI	New UI
Add user	Invite User	Add User
Merge users	Profile merge	Users list → Merge Account (with Primary Account)
Delete user	Varied by setup	Users list → Delete User (and Restore User from deleted users)
View billable users	Separate billing view	Billable Users filter (where enabled)
Filter users	Legacy Git/team filters	Add Filter + Edit Columns

---

Important: SSO user provisioning behavior

• When Single Sign-On (SSO) is enabled, users are provisioned in LinearB only after their first successful SSO login.
• LinearB attempts to unify identities across SSO, Git providers, and project management tools.
• Automatic unification requires a 100% email address match between the SSO user and external identities.
• If email addresses do not match exactly, a person may appear as multiple accounts and a manual merge is required to unify activity and reporting.

Note: Correct identity merging is especially important for features such as Surveys, where responses must be attributed to the correct user account.

SSO gotchas

• Until a user logs in for the first time, they may not appear in Settings → Users & Teams. Ask new users to log in once via SSO before assigning roles or teams.
• You cannot modify permissions until the user has logged in at least once and a platform user record exists.