How To Recover Site Access With BetterShield?
Locked out of WordPress by BetterShield? Use your recovery link or a recovery code to pause its protections for an hour and sign in again.
If BetterShield is stopping you from signing in, your recovery link or a recovery code pauses its protections for one hour, with nothing deactivated and no setting changed. You manage both under BetterShield › Protection › Recovery.
Step 1: Use Your Recovery Link
The recovery link is a private address for your site. BetterShield emailed it to the site’s administration email address when you activated it, with the subject “[your site] Your BetterShield recovery link” (your site’s title in the brackets). Generate a New Link on Protection › Recovery makes a new one. If a link has been used since, the newest one arrived in an email titled “[your site] Your BetterShield recovery link was used”. A link you generated on the Recovery screen, or printed with wp bettershield recover --new-link, was shown there, not emailed.
- Open the newest link in your browser. Opening it changes nothing yet.
- On Pause protection and get back in?, press Pause protection and continue.
- The Protection is paused page says when the pause ends. Under Save your next recovery link it shows a new link: copy it somewhere safe now. A copy is also emailed to the administration address.
- Press Go to sign-in and sign in with your username and password.
Each link works once: using it spends it and issues the next one straight away. A link also stops working 90 days after it was issued, or as soon as a newer one is generated. A spent, replaced or expired link is turned away when you press the button, with “This recovery link or code is not valid. Each is good for one use, and stops working the moment it is used.”
What safe mode pauses
For that hour BetterShield stops enforcing its protections, so the standard sign-in page works again. Paused: lockouts and the block list, the limits on comments, password reset requests and sign-ups, a moved sign-in address, session limits, the hidden bot check and the sign-in puzzle, the two-factor step and the two-factor requirement, passkey-only sign-in, every hardening fix that runs inside WordPress except the strengthened sign-in keys (they stay in use, so nobody is signed out), the password rules and the breached-password check, a lockdown, and the password confirmation prompt. Rules written to .htaccess and index files (hiding sensitive files, PHP in uploads, directory listings) stay in place; they never affect signing in. Your settings stay as they were, and everything comes back when safe mode ends.
While it lasts, the Overview and each Protect tab show Protection is paused. with the time it ends, and End safe mode now ends it sooner. The activity log records “Safe mode started”, which is also emailed to your alert recipients as it happens (when instant alerts are enabled), and “Safe mode ended”. A pause that came from the network’s recovery link is ended from Network Admin: End the pause now on BetterShield › Network, or wp bettershield recover --end --network. End safe mode now and wp bettershield recover --end end only a site’s own pause.
If the site is locked down, safe mode stands the lockdown down too, but it returns when safe mode ends. Sign in and press Lift the lockdown on the Recovery tab while safe mode lasts. See Lock the site down.
Step 2: Use a Recovery Code
Recovery codes work without email. Each sheet lists eight codes and the address to use them at.
- Open the address printed on the sheet with one code added to the end. Hyphens and capitals do not matter.
- Press Pause protection and continue. Only that code is spent; your other codes keep working.
- The Protection is paused page says how many codes you have left. Press Go to sign-in.
A code does not issue a new link. When your codes run low, issue a new set from the Recovery screen.
Step 3: Restore Access Through Your Host
- Locked out after wrong passwords. A sign-in lockout ends on its own (15 minutes by default, longer if it keeps happening within a day). An automatic notice is sent only for a network the account used within the last 30 days, or when its correct password was used. Otherwise choose Email Me an Unlock Link on the sign-in screen and enter your username or email address. If the lockout qualifies, the saved account address receives a link: open it and press Clear the Lockout.
- Another administrator can still sign in. They can generate a new recovery link for you under Protection › Recovery, or fix whatever is blocking you.
- You or your host can run WP-CLI.
wp bettershield recoverturns safe mode on for one hour and needs no user account. Add--hours=4for longer (1 to 24 hours) or--new-linkto print a fresh recovery link (the old one stops working).wp bettershield recover --endends the site’s own safe mode early. Add--networkto end the network’s pause instead.
Lost your two-factor device
- Use a backup code. Setting up two-factor gave you ten backup codes. On the code screen, type one in place of the app code. Each works once.
- No backup codes left? An administrator can open your account under Users, find Two-factor sign-in and press Turn off two-factor for this account. You then sign in with your password and set two-factor up again.
- The only administrator? Your recovery link or a recovery code gets you into the dashboard, because the two-factor step is not asked while safe mode lasts. While safe mode is on, Turn off on Protection › Two-Factor takes your password and turns two-factor off for your account (Turn two-factor off), and an alert goes out when it does. Set it up again once you have a device.
Before you need it
Set up your recovery link and recovery codes, and check that they would work, on Set up recovery. It also covers the check BetterShield runs before a change to how people sign in, and the network’s own recovery link on multisite. For the emergency switch that closes the dashboard, see Lock the site down.
Final Outcome
A valid recovery link or code starts safe mode for one hour so you can sign in and correct the setting that blocked access. Test your normal sign-in and keep new recovery details outside the site.
Related
This is how you can recover access with BetterShield and prepare a working way back in.
Getting Stuck? Feel free to contact our Dedicated Support Team.