Skip to main content

Managing Users in the Users & Teams – Users Tab

View, edit, merge, and manage user accounts in the unified Users experience, including memberships, permissions, and connected identities.

Steven Silverstone
Updated by Steven Silverstone

The Users page in LinearB provides a centralized way to view, add, edit, merge, and manage user accounts across your organization. It consolidates user details, permissions, team membership, and connected systems into a single, unified interface.

Company-level settings apply by default. Team-level settings override them where applicable.

Summary
  • Access all users from Settings → Users & Teams → Users.
  • View permissions, team membership, and external connections in one table.
  • Add, edit, merge, or delete users directly from the Users page.
  • Manage billing-relevant users and restore deleted users when needed.

Accessing the Users page
  1. From the left navigation menu, select Settings.
  2. Open the Users & Teams tab.
  3. Ensure Users is selected (next to Teams).

User list overview

The Users table displays the following columns:

Name The user’s display name and avatar.
Email The primary email address associated with the user.
LinearB Permissions The assigned role (Admin, Editor, Viewer).
Team Membership The teams the user belongs to, or the total number of teams.
Connections Icons representing connected systems, including Git providers (for example, GitHub or GitLab) and project management tools (such as Jira or Azure Boards).
Created At The date the user was added to LinearB.

Searching, filtering, and columns
  • Use Search to find users by name or email.
  • Click Add Filter to filter by:
    • User role
    • Team membership
    • Connection status (Git, project management, or platform)
    • Billable users
  • Use Edit Columns to show or hide table columns.
  • Click Show deleted users to view and restore removed accounts.

Adding a new user
  1. Click Add User.
  2. In the New User panel, enter:
    • Full name
    • Email
    • User role
  3. Optionally configure:
    • Team scope – Which teams and groups the user can access.
    • Role-based modules – For example, developer coaching.
    • Team membership – Assign the user to one or more teams.
  4. Click Save & Close.

Editing a user
  1. Locate the user in the table.
  2. Click the three-dot menu.
  3. Select Edit Profile.
  4. Update permissions, team membership, or scope.
  5. Save your changes.

Merging user accounts

Merging allows you to consolidate multiple accounts that represent the same person into a single unified user.

  1. Open the user’s three-dot menu.
  2. Select Merge Account.
  3. Select one or more additional accounts.
  4. Choose the Primary Account.
  5. Save the merge.

Bulk merging suggested accounts

Use Bulk Merge to review and merge multiple merge suggestions at once. LinearB suggests potential merges and assigns each suggestion a confidence score.

To bulk merge accounts:

  1. Go to Settings > Users & Teams > Users.
  2. Click Bulk Merge.
  3. In Bulk Merge Accounts, adjust the confidence threshold slider (for example, 92% or higher confidence) to control how strict the suggestions are.
  4. Review the suggested merges:
    • Expand a suggestion to see the accounts that will be merged together.
    • Use the checkbox to include or exclude a suggestion from the bulk merge.
  5. Optional: If needed, change which account is the Primary (see Set a primary account in Bulk Merge below).
  6. Click Merge to apply the selected merges.

Notes

  • Use a higher threshold to reduce false positives.
  • Click Load More to display additional suggestions.

Set a primary account in Bulk Merge

Each suggested merge group has a Primary account. The Primary account is the identity that LinearB keeps as the authoritative user after the merge.

To set a different primary account:

  1. In Bulk Merge Accounts, locate the suggested merge group.
  2. On the account you want to make primary, open the three-dot menu.
  3. Select Set as primary.
  4. Confirm the Primary badge moved to the correct account, then click Merge.

Primary account behavior

During a merge, you must select a Primary Account.

  • The primary account becomes the authoritative identity across LinearB.
  • Its name, email, avatar, and permissions are used throughout the platform.
  • Permissions are inherited only from the primary account.
  • Secondary accounts are retained internally to preserve historical data.
  • In Bulk Merge, you can change the Primary account directly in the Bulk Merge list using Set as primary before running the merge.

Team membership behavior
  • The merged user belongs to all teams associated with any merged account.
  • Team membership is additive.
  • Permissions are not combined across accounts.

Deleting and restoring users

Use Delete User to remove a user from LinearB. Deleted users are excluded from billing and reporting.

  • Deleted users can be restored from Show deleted users.
  • Historical data is preserved.

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.

Tips and best practices
  • Limit Admin permissions to users who require full control.
  • Ensure Git and PM connections are configured for accurate metrics.
  • Use filters and column controls to manage large organizations.

How did we do?

Auto-Merge for Contributors in LinearB

Migrating to the New Unified User Management UI

Contact