User Types and Access Control

Category: Organizations
On this page:

    Users in Bitwarden Organizations can be granted a variety of User Types and Access Controls in order to manage their permissions and access. You can set User Types and Access Controls when you invite users to your Organization, or at any time from the ManagePeople screen in your Organization:

    Editing User Types and Access Control
    Editing User Types and Access Control

    User Types

    User Type determines the permissions a user will have within your Organization. User Types does not determine which Collections they have access to, rather it determines what actions they can take within the context of your Organization’s resources and tools. Options include:

    User Type Permissions
    User Access shared items in assigned Collections
    Add, edit, or remove items from assigned Collections (unless Read Only)
    Manager All of the above,
    + Assign Users to Collections
    + Assign User Groups to Collections
    + Create or delete Collections
    Admin All of the above,
    + Assign Users to User Groups
    + Create or delete User Groups
    + Invite and confirm new Users
    + Manage Enterprise Policies
    + View Event Logs
    + Export Organization Vault data
    + Manage Password Reset

    Admin Users automatically have access to all Collections.
    Owner All of the above,
    + Manage Billing, Subscription, and Integrations

    Owner Users automatically have access to all Collections.
    Custom Allows for granular control of user permissions on a user-by-user basis, see Custom Role.

    Only an Owner can create a new Owner or assign the Owner type to an existing user. For failover purposes, Bitwarden recommends creating multiple Owner users.

    Custom Role

    Selecting the Custom role for a user allows for granular control of permissions on a user-by-user basis. A Custom role user can have a configurable selection of Manager and Admin capabilities, including:

    • Manage Assigned Collections (provides the following 2 options)
      • Edit Assigned Collections
      • Delete Assigned Collections
    • Access Event Logs
    • Access Import/Export
    • Access Reports
    • Manage All Collections (provides the following 3 options)
      • Create New Collections
      • Edit Any Collection
      • Delete Any Collection
    • Manage Groups
    • Manage SSO
    • Manage Policies
    • Manage Users
    • Manage Password Reset

    As an example, the Custom role allows for the creation of a user that can manage a User-Group-Collection relationship, without the ability to see anything in a Collection to which they are not assigned or delete any Collection. This scenario would involve selecting only the following boxes for this Custom user:

    • Manage Assigned Collections → Edit Assigned Collections
    • Manage Groups
    • Manage Users

    Access Control

    Access Control determines access to Collections, as well as permissions within each individual Collection:

    Configure Access Control options
    Configure Access Control options

    Recall that Admins and Owners can automatically access all Collections. For these user types, configuring Access Control will determine which Collections are readily accessible in their Personal Vault and client applications (Browser Extension, Mobile, etc.). Admins and Owners will still be able to access “unassigned” Collections from the Organization Vault.

    Access Control Description
    This user can access and modify all items Grants the user(s) access to all Collections, as well as the ability to modify Vault items stored therein.

    Selecting this option will collapse the Collection selection section.
    This user can access only the selected Collections Grants the user(s) access to only selected Collections, as well as granular access control over permissions for each Collection.

    Selecting this option will expand the Collection selection section.

    Granular Access Control

    If you selected This user can access only the selected Collection, choose which Collections you want to provide them access to. For each Collection, you can also configure the following options:

    Option Description
    Hide Passwords Prevents users from seeing or copying all passwords, TOTP seeds, or Hidden custom fields. Users with Hide Passwords active may only use items in the Collection via Auto-Fill.

    Hide Passwords prevents easy copy-and-paste of hidden items, however it does not completely prevent user access to this information. Treat hidden passwords as you would any shared credential.
    Read Only Prevents users from adding, editing, or removing items within the Collection. Users with Read Only access may still see and use all passwords, TOTP seeds, and Hidden custom fields.