White Screen or Fatal Error
If your site shows a white screen (WSOD) or fatal error after enabling a Royal Security feature, follow these steps to recover and fix the issue.
If you're completely locked out, skip to Step 1: Disable via FTP below to regain access first.
Common Causes
PHP Version Incompatibility
Some hardening features require PHP 7.4+. Older PHP versions may crash.
Memory Limit Too Low
Security scans and firewall rules need adequate memory. Default 64MB may not be enough.
Plugin Conflict
Another security plugin or caching plugin may conflict with the same hooks.
.htaccess Corruption
Hardening rules written to .htaccess may conflict with existing rules.
File Permission Issues
The plugin can't write to required files (wp-config.php, .htaccess).
Step 1: Disable the Plugin via FTP
First, regain access to your site by temporarily disabling Royal Security.
Connect via FTP/SFTP
Use FileZilla, Cyberduck, or your hosting's file manager to connect to your server.
Navigate to the plugins folder
Go to /wp-content/plugins/
Rename the Royal Security folder
Rename royal-security (or royal-security-lite) to royal-security-disabled
Access your site
Your site should now load. Log into WordPress admin.
Step 2: Check the Error Log
Before re-enabling the plugin, find out what caused the crash.
Enable WordPress Debug Mode
Add these lines to your wp-config.php file (before "That's all, stop editing!"):
View the Debug Log
Check /wp-content/debug.log for error messages. Look for lines mentioning "royal-security" or "fatal error".
Check Server Error Logs
Your hosting control panel usually has an "Error Logs" section. Check there for PHP fatal errors.
Step 3: Fix the Issue
Based on the error message, apply the appropriate fix:
PHP Version Error
If you see errors about unsupported syntax or missing functions:
- Log into your hosting control panel
- Find PHP version settings (often under "Software" or "PHP Selector")
- Switch to PHP 7.4 or higher (8.0+ recommended)
- Clear any caching and test your site
Memory Limit Error
If you see "Allowed memory size exhausted":
Or add to .htaccess:
.htaccess Corruption
If the error mentions .htaccess or mod_rewrite:
Backup current .htaccess
Rename .htaccess to .htaccess.backup
Create fresh .htaccess
Go to WordPress → Settings → Permalinks and click "Save Changes" to regenerate.
Test your site
If it works, the old .htaccess had conflicting rules.
Plugin Conflict
If the error mentions another plugin:
- Disable all other security plugins (Wordfence, Sucuri, iThemes, etc.)
- Disable caching plugins temporarily
- Re-enable Royal Security
- Test - if it works, the conflict was with the other plugin
Step 4: Re-enable Royal Security
Once you've fixed the underlying issue:
Rename the plugin folder back
Via FTP, rename royal-security-disabled back to royal-security
Activate the plugin
Go to Plugins in WordPress admin and activate Royal Security.
Enable features one at a time
Don't enable all features at once. Turn on one feature, test, then add the next.
Disable debug mode
Set WP_DEBUG back to false in wp-config.php.
If you're not sure which feature caused the crash, enable them one at a time. This helps identify problematic configurations on your specific server setup.
Still Having Issues?
- Check your hosting's PHP error logs for specific error messages
- Ensure your hosting meets the minimum requirements
- Try a fresh install: delete the plugin folder and reinstall from scratch
- Contact support with your debug.log contents