1Password QR Code Detection Failed | Scan Fixes Fast

Guide / By

If 1password qr code detection failed shows up, fix camera or screen-capture access, then use the manual setup key if needed.

Scanning a QR code inside 1Password should feel simple. You’re adding a one-time password (TOTP) to a login, you hit Scan QR Code, and you save. When you get a “detection failed” message instead, it feels like the app is ignoring something that’s right in front of you.

This guide covers two cases: saving a TOTP to a login and scanning a QR during 1Password sign-in. Start with quick checks, then platform fixes, then a fallback that still lets you finish setup.

What The Message Means In Plain Terms

The scanner is trying to read data from the QR and turn it into a valid action. When it can’t extract a valid payload, you see the failure message. Most of the time, the QR itself is fine. The trouble is the path between the camera or screen capture and the decoder.

There are three buckets that account for most cases:

  • Capture Issues — The camera can’t focus, lighting adds glare, the QR is too small, or the desktop app can’t capture your screen.
  • Permission Issues — The app is blocked from the camera, or macOS screen recording access is off.
  • Format Issues — The QR is not a standard TOTP setup link, or the site is locked to a specific authenticator flow.

Before you change settings, check what you’re scanning. Is the QR on the same device’s screen, or on a second device? A QR on your own display is a screen-capture problem on desktop. A QR on another device is a camera and focus problem.

If you keep seeing 1password qr code detection failed on mobile, start with camera permission, focus, and glare control.

1Password QR Code Detection Failed When Adding TOTP

When you add a one-time password in 1Password, the QR code usually encodes a URL that begins with otpauth://. If the decoder doesn’t get a clean read, or if the QR encodes something else, the scan won’t complete.

If you’re adding a TOTP to a login, success is a saved one-time password field with a rotating 6-digit code. Scanning is one route. Manual entry can work when scanning fails.

Fast Fixes You Can Try First

These take a few minutes and solve a lot of cases without deeper troubleshooting.

  1. Make The QR Bigger — Zoom the page so the QR fills more of the screen, while keeping a quiet white border around it.
  2. Reduce Glare — Tilt the screen slightly and add side light, not a bright overhead reflection.
  3. Hold Still After Focus — Let the camera lock focus, then pause for a second before moving.
  4. Close And Reopen 1Password — Quit the app fully, reopen, unlock, then retry.
  5. Update The App And Extension — Install the latest 1Password app and browser extension versions before you chase edge cases.

If the QR is on your own desktop screen and you’re on a Mac, jump straight to the screen recording section below. That one setting causes a lot of “it used to work” reports.

If the QR sits inside a small modal, open it in a full browser tab before scanning.

Device Checks On iPhone, iPad, And Android

Phones are often the smoothest place to scan, since the camera feed is direct. When scanning fails on mobile, it’s usually a permission, an app state issue, or a QR that is too dense for the camera to decode at that distance.

Camera Permission And App State

Start by confirming the OS still allows 1Password to use the camera. Permissions can change after OS updates, profile changes, or app reinstalls.

  • Check Camera Access — In system privacy settings, confirm Camera is allowed for 1Password, then reopen the app.
  • Remove Overlays — Disable screen filters, magnifiers, or floating tools that sit on top of the camera view.
  • Force Close The App — Close 1Password fully, reopen it, unlock, and retry the scan.

Make The QR Easier For The Camera

Some QR codes pack a lot of data into a small space. Small squares and low contrast create a narrow margin for error.

  • Increase Contrast — Use a light background and a crisp QR, not a dark mode panel with gray tones.
  • Adjust Distance — Move closer until the QR fills most of the view, then back off slightly if the camera can’t focus.
  • Lower Screen Brightness — Drop the brightness on the device showing the QR so the camera doesn’t blow out the edges.

Use A Manual Setup Key When The Site Offers It

Many sites show a “can’t scan?” link under the QR. That reveals a setup key you can copy. This route skips camera decoding entirely and still produces the same rotating codes.

Check For Authenticator Restrictions

Some work accounts steer users into a specific authenticator app. In that setup, the QR you see may not be a plain TOTP QR that 1Password can store.

  • Pick A Different Authenticator Option — If the page offers “use a different authenticator app,” choose it before scanning.
  • Try A Different Site — Test scanning a known standard TOTP QR to confirm the scanner works on your device.

Desktop Checks On Mac, Windows, Linux, And Browser Extensions

On desktop, 1Password may scan from a camera, from your clipboard, or from your screen. The screen route is where permissions and scaling get in the way.

Mac Screen Recording Access For On-Screen QR Codes

macOS protects screen capture behind the Screen Recording permission. If it’s off, stale, or blocked, 1Password can’t read a QR shown on your screen.

  1. Open System Settings — Go to Privacy & Security, then Screen Recording.
  2. Enable 1Password — Turn on access for 1Password and any helper it lists.
  3. Quit And Reopen — Close 1Password fully and reopen it so macOS applies the permission change.

Browser Extension Reset Steps

Extension scanning depends on the browser UI and capture features. A quick reset often clears the failure.

  1. Restart The Browser — Quit the browser, reopen it, then unlock 1Password again.
  2. Update The Extension — Install the newest 1Password extension build for your browser.
  3. Disable Conflicting Extensions — Turn off blockers or privacy add-ons for one test run, then try scanning again.
  4. Try A Fresh Profile — Create a clean browser profile, install only 1Password, and test the scan.

If you use Safari, test scanning after disabling Reader mode and zoom.

Display Scaling And QR Clarity On Windows And Linux

If the QR code is on your screen and your OS scale is high, the QR can look fine while still being slightly blurred at the pixel level. That blur can be enough to break decoding.

  • Set Scale To 100% — Test scanning with display scaling set to 100%, then restore your preference after.
  • Use Browser Zoom Carefully — Zoom the QR larger, but avoid odd zoom levels that create soft edges.
  • Switch To Another Screen — Move the QR to a different monitor with sharper text rendering.

Manual Setup When Scanning Won’t Work

If scanning keeps failing, stop repeating the same attempt. Many sites show a setup key you can paste into a one-time password field.

The table below helps you pick the right fallback based on what the site shows.

What You See Why Scan Fails What To Do
QR code only Screen capture or camera read is failing Open the site’s manual entry option, or scan the QR with a phone
QR plus setup key QR read fails, but the secret is available Copy the setup key and add a one-time password manually
Authenticator app is forced QR may not be standard TOTP Select “different authenticator” if offered, then try again

Manual Entry Steps In 1Password

The labels vary a bit by platform, yet the flow is the same: edit the login item, add a one-time password field, then enter the secret key from the site.

  1. Open The Login Item — Find the login for the site where you’re turning on two-factor sign-in.
  2. Enter Edit Mode — Tap or click Edit so you can add fields.
  3. Add One-Time Password — Choose Add More, then One-Time Password.
  4. Paste The Setup Key — Paste the secret the site shows, then save the item.

After saving, you should see a rotating code in the login item. On some sites, the code can fill automatically from the browser extension when you’re prompted for a verification code.

QR Sign-In Scan Failure In 1Password

A QR code can also be used to sign in or link a device to your 1Password account. In that flow, failures are often tied to an expired QR, a stale app state, or device time being out of sync.

If you see the error while linking a device, run this short reset loop:

That usually clears the loop.

  1. Generate A Fresh QR — Cancel the flow and create a new QR on the device you’re signing in on.
  2. Set Time Automatically — Turn on automatic date and time so tokens line up.
  3. Keep 1Password In Front — Stay in the scanner view while you scan, with no fast app switching.
  4. Switch Networks — Try a different Wi-Fi or cellular connection if the flow needs an account handshake.

If QR sign-in keeps failing, use the standard sign-in method with your account details for now, then return to QR sign-in after you’re fully signed in and updated across devices.

When You Need Extra Help

If you’ve tried the checks above and you still hit the same message across multiple QR codes, gather a small set of details before contacting 1Password’s help team. That cuts down on back-and-forth and gets you to a real fix faster.

  • Record Versions — Note your device model, OS version, 1Password app version, and extension version.
  • Describe The QR Source — Say if the QR was on your screen, another device, or printed on paper.
  • Test A Known TOTP QR — Try a different site that uses standard TOTP to see if the issue is site-specific.
  • Recheck Permissions — Confirm camera access on mobile and Screen Recording access on macOS.

1Password’s help pages on one-time passwords, macOS screen recording, and browser troubleshooting line up with the checks above. If you want a step list for your device, open those articles and follow the permission prompts.

One last safety net is straightforward: if the site shows a setup key, use manual entry and move on. You still end up with working verification codes inside 1Password, and you can stop fighting the scanner.