Skip to content

How to Troubleshoot Two-Factor Sign In

Start with the message the customer sees, then the Activity screen for their account.

  • The phone’s clock is wrong. Codes depend on the time. Ask the customer to set the time automatically. If many customers have it, widen Clock Tolerance under Configuration → General.
  • They used the same code twice. A code works once. They wait for the next one.
  • They have more than one entry for your store in the app, from an earlier setup. Only the newest works. They delete the old one.
  • They typed a recovery code on the App code tab, or the other way round.
  • The license is not active, or Two-Factor Authentication is off. The dashboard banner says which.
  • The user is in Excluded Users.
  • The user has not turned 2FA on. Users shows Off.
  • The browser is trusted. Ask them to press Remove all under Trusted devices.

The code screen lasts 10 minutes. The customer signs in again.

The account is locked for Lockout Duration (Minutes). Wait, or reset their 2FA if they cannot get a code. The activity log shows where the wrong codes came from. See How to Lock Out Repeated Wrong Codes.

Check your store sends other emails, such as order emails. Ask the customer to look in spam. They can ask for a new one after a minute, three times per sign in.

“We upgraded the security of two-factor authentication. Please set it up again with the new QR code below.” This shows for accounts set up on version 1, and after your site’s salts change. See How to Upgrade from Version 1.

Reset their 2FA. See How to Reset a Customer’s 2FA After a Lost Phone.