How to Troubleshoot Two-Factor Sign In
Start with the message the customer sees, then the Activity screen for their account.
“That code is not valid”
Section titled ““That code is not valid””- 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.
No code screen
Section titled “No code screen”- 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.
“Your sign in session expired”
Section titled ““Your sign in session expired””The code screen lasts 10 minutes. The customer signs in again.
“Too many wrong codes”
Section titled ““Too many wrong codes””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.
No email code arrives
Section titled “No email code arrives”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.
Asked to set it up again
Section titled “Asked to set it up again”“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.
Lost phone, no codes
Section titled “Lost phone, no codes”Reset their 2FA. See How to Reset a Customer’s 2FA After a Lost Phone.

