Skip to content

Two-Factor Authentication

Secure your account with two-factor authentication (2FA).

Two-factor authentication (2FA) adds an extra layer of security to your administrator account. Even if someone discovers your password, they won't be able to access your account without the second factor.

What is Two-Factor Authentication?

2FA requires two forms of verification:

  1. Something you know - Your password
  2. Something you have - A code from your phone

This means an attacker would need both your password AND your phone to access your account.

Enabling Two-Factor Authentication

Step 1: Access Security Settings

  1. Click your avatar at the top right of the header
  2. Select Personal Account
  3. Find the Two Factor Authentication section

The section only appears when two-factor authentication is turned on for your store. If you do not see it, ask your developer to turn it on.

Two-Factor Section

Step 2: Start Setup

  1. Click Enable Two Factor
  2. In the Confirm Password window, enter your password and click Confirm

Two-factor authentication is turned on right away. The section now shows a QR code and your recovery codes.

Step 3: Scan QR Code

  1. Install an authenticator app on your phone:

    • Google Authenticator
    • Authy
    • Microsoft Authenticator
    • 1Password
  2. Open the app and scan the QR code displayed on screen. The QR code is shown only now: to use a second device, scan it with that device too before you leave the page

  3. The app generates a 6-digit code for your store

Step 4: Verify Setup

Shopper does not ask for a code at this point. Before you leave the page, check that your authenticator app shows a 6-digit code for your store: from your next login, you need it to sign in.

Two-Factor Code

Step 5: Save Recovery Codes

Below the QR code, Shopper shows 8 recovery codes. Save these securely!

Each recovery code lets you sign in once if you lose your phone. To see them again later, click Show Recovery Codes in the Two Factor Authentication section. Regenerate Recovery Codes replaces all of them with new ones.

Store your recovery codes in a safe place, like a password manager or a secure physical location. Don't store them on your phone.

Logging In with 2FA

After enabling two-factor authentication:

  1. Enter your email and password as usual
  2. The Authenticate Your Account screen asks for a code
  3. Open your authenticator app
  4. Enter the 6-digit code in the Code field
  5. Click Login

To use a recovery code instead, click Use a recovery code.

Two-Factor Login

Disabling Two-Factor Authentication

If you need to disable 2FA:

  1. Click your avatar at the top right, then Personal Account
  2. Find the Two Factor Authentication section
  3. Click Disable
  4. If the Confirm Password window opens, enter your password and click Confirm
Disable Two-Factor

Only disable 2FA temporarily if necessary. Re-enable it as soon as possible to maintain account security.

Recovery Options

Lost Your Phone?

If you've lost access to your authenticator:

  1. Use a recovery code - On the login screen, click Use a recovery code and enter one of your saved codes
  2. Contact your developer - No screen in the admin turns off another administrator's 2FA, so your developer turns it off for your account
  3. Use backup device - If you scanned the QR code with a second device during setup

Recovery Codes

Each recovery code can only be used once. After using a code:

  • That code is no longer valid
  • Shopper replaces it with a new one: click Show Recovery Codes in your profile to save the updated list
  • Click Regenerate Recovery Codes if you think someone else has seen your codes

Best Practices

Enable for All Admins

Ask every staff member with admin access to turn on 2FA from their profile. Shopper does not force it.

Secure Recovery Codes

Store recovery codes separately from your password.

Use a Trusted App

Choose a reputable authenticator app.

Backup Device

Set up 2FA on a backup device if possible.

AppPlatformFeatures
Google AuthenticatoriOS, AndroidSimple, widely supported
AuthyiOS, Android, DesktopCloud backup, multi-device
Microsoft AuthenticatoriOS, AndroidMicrosoft integration
1PasswordAll platformsPassword manager integration

Troubleshooting

Code Not Working?

  • Check the time - Your phone's time must be accurate
  • Try the next code - Codes refresh every 30 seconds
  • Use a recovery code - If you can't generate valid codes

Locked Out?

  1. Try using a recovery code
  2. Ask your developer to turn off 2FA for your account
  3. As a last resort, contact technical support

For developer details, see the Two-Factor Authentication documentation.

Last updated on

Edit on GitHub