Get help

If the 1Password browser extension doesn’t unlock when you unlock the 1Password app

Get help if 1Password in your browser doesn’t connect with the 1Password desktop app.

Make sure you’re using a supported browser

If the 1Password browser extension doesn’t lock or unlock when you lock or unlock the 1Password desktop app, make sure you’re using a supported browser:

the Chrome logo Chrome 

the Firefox logo Firefox 

the Edge logo Edge 

the Brave logo Brave 

the Safari logo Safari 

Tip

Learn how to add additional trusted browsers on your Mac or Linux computer.

Make sure 1Password and your browser are up to date

Make sure you have the latest version of the 1Password desktop app, the 1Password browser extension, and your browser installed.

Check your settings

If that doesn’t fix the issue, make sure you have the appropriate settings turned on in both the app and the browser extension:

1Password desktop app

  1. Open and unlock the 1Password app.
  2. Select your account or collection at the top of the sidebar and choose Settings.
  3. Select Browser in the sidebar and make sure Connect with 1Password in the browser is turned on.

    Get help if you see “We weren’t able to connect to the 1Password extension in your browser."

  4. Right-click the 1Password icon in your menu bar or system tray and select Quit, then reopen the 1Password app.

1Password browser extension

  1. Select the 1Password button in your browser’s toolbar to open and unlock 1Password.
  2. Select the 1Password in your browser menu and choose Settings.
  3. Select General and make sure Integrate this extension with the 1Password desktop app is turned on.
  4. Restart your browser.

If you’re using macOS Ventura or later

If you’re using macOS Ventura or later, make sure 1Password has permission to perform tasks in the background:

  1. Choose Apple menu > System Settings.
  2. Select General in the sidebar, then select Login Items & Extensions.
  3. In the “Allow in the Background” section, make sure 1Password is turned on.

    If you see a blank file icon beside the entry for 1Password, contact 1Password Support for further assistance.

If you’re using a Windows PC

If your Windows username contains characters other than numbers and letters (for example: & or spaces), 1Password for Windows may not be able to communicate with 1Password in your browser.

To check for special characters in your Windows username:

  1. Select the Start button and type “Command Prompt”, then press Enter.

  2. Copy and paste the following command, then press Enter:

     whoami

If you see any special characters in your username, such as a space, follow these steps:

  1. In your browser, copy and paste the appropriate address below into your address bar, then press Enter:
    • Chrome: chrome://flags/#launch-windows-native-hosts-directly
    • Edge: edge://flags/#launch-windows-native-hosts-directly
    • Brave: brave://flags/#launch-windows-native-hosts-directly
  2. Select the menu for Force Native Host Executables to Launch Directly and choose Enabled.

If you continue to have issues after you change this setting, or if you use a different browser, contact 1Password Support for help.

If you’re using a Linux computer

If you installed 1Password for Linux or your browser using a containerized package manager such as Snap or Flatpak, the app won’t be able to communicate with 1Password in your browser.

To use 1Password for Linux with the 1Password browser extension, make sure you’ve installed both 1Password for Linux and your preferred browser using an installation method other than Snap or Flatpak, such as through your distribution’s built-in package manager.

To reinstall 1Password for Linux

To reinstall 1Password for Linux from a 1Password repository:

  1. Uninstall 1Password for Linux using the package manager you installed it with.
  2. Install 1Password for Linux using the steps for your Linux distribution.

To reinstall your browser

Tip

If the default browser for your Linux distribution doesn’t communicate with 1Password for Linux, it may be installed through a containerized package manager.

For example, on Ubuntu 22.04 or later, Firefox is installed as a Snap package by default, even if you installed it through apt.

If your browser is installed through a containerized package manager, uninstall the default version of your browser and reinstall it using a traditional package manager. For example, you can install the Firefox .deb package on Debain-based Linux distributions after you uninstall the containerized version of Firefox.

If your computer is managed by your organization

If your computer is managed by your organization, make sure your IT team allows browser extensions to communicate with apps on your computer through native messaging:

  1. In your browser, copy and paste the appropriate address below into your address bar, then press Return or Enter:
    • Chrome: chrome://policy
    • Edge: edge://policy
    • Brave: brave://policy
  2. Copy and paste NativeMessagingUserLevelHosts into the policy filter box in the top right.

If you see a result for NativeMessagingUserLevelHosts with a value set to false, contact your IT team for further assistance. The 1Password browser extension won’t be able to connect with the 1Password desktop app unless this policy is changed.

Get more help

If you’re still having trouble:

  1. Create a diagnostics report in your browser.
  2. Contact 1Password Support with a description of the problem and attach the diagnostics report that you created.

Appendix: Add additional trusted browsers

To add an additional trusted browser in 1Password on your Mac:

  1. Open and unlock 1Password for Mac.
  2. Select your account or collection at the top of the sidebar, then select Settings.
  3. Select Browser in the sidebar, then select Add Browser.
  4. Choose a browser that’s code signed by Apple from the Applications folder.

To add an additional trusted browser in 1Password on your Linux computer:

  1. Make sure 1Password and your browser aren’t installed with a containerized package manager like Flatpak or Snap.

  2. Open 1Password for Linux, then select the vertical ellipsis > Quit.

  3. Quit any browsers you’d like to add.

  4. Open your terminal and run the following command to create a custom_allowed_browsers file in the /etc/1password directory.

     sudo mkdir -p /etc/1password && touch /etc/1password/custom_allowed_browsers

  5. Open the custom_allowed_browsers file in your text editor.

  6. Enter the binary name for your browser. For example: librewolf for LibreWolf.

    To add multiple browsers, separate each addition with a line break.

  7. Save the custom_allowed_browsers file, then run the following command in your terminal to give it the appropriate permissions:

     chown root:root /etc/1password/custom_allowed_browsers && sudo chmod 755 /etc/1password/custom_allowed_browsers

  8. Reopen and unlock 1Password for Linux. The 1Password app will automatically detect the additions to the custom_allowed_browsers list.


Published: