If your authenticator app can’t scan the 2FA QR code during setup (blurry screen, camera issues, or the code doesn’t register), use the manual entry method instead.
Enter the secret key manually
Below the QR code on the 2FA setup page, WP Ghost displays a text-based secret key. Open your authenticator app (Google Authenticator, Authy, Microsoft Authenticator, etc.), select Enter a setup key (or Manual entry), type in the account name (your site name and username), and paste the text key. This produces the same TOTP codes as scanning the QR code.
QR code scanning tips
If you’d prefer to scan rather than type, try zooming in on the QR code (use your browser’s zoom or Ctrl/Cmd +), increase your screen brightness, hold your phone at a steady distance, and make sure no screen overlays or dark mode filters are distorting the code. On high-DPI displays, the QR code may render too small by default.
If you’ve already set up 2FA but need to re-scan, an administrator can reset the key at Users > Edit User > Reset Key in the WP Ghost 2FA section. See Authenticator App Not Generating Valid Codes for more 2FA troubleshooting.