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.

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.

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