What is a WordPress fatal error?
A "fatal error" in WordPress means that a critical error has occurred which stops the code from running. It can have various causes:
- Incompatible plugin updates
- A PHP version conflict
- Faulty theme files
- Corrupted WordPress core files
Immediate steps when a fatal error occurs
If your WordPress website shows a fatal error, you should act quickly but deliberately:
1. Use recovery mode
Since version 5.2, WordPress has had an automatic recovery mode. If a plugin or theme causes a fatal error, WordPress automatically tries to keep the admin area accessible.
2. Access the website via FTP
Connect to your server via FTP and navigate to the plugins folder:
/wp-content/plugins/
3. Deactivate the problematic plugin
Rename the folder of the problematic plugin (for example from "woocommerce" to "woocommerce_deactivated"). WordPress will deactivate the plugin automatically.
Fixing a WooCommerce fatal error
WooCommerce errors are particularly delicate because they often take down the entire shop. Here is a detailed procedure:
Step 1: Create a backup
Before you make any changes, create a complete backup of your website. You can do this via:
- Your hosting control panel
- An FTP download of all files
- A database export via phpMyAdmin
Step 2: Enable debug mode
Enable WordPress debug mode to get more information about the error. Open wp-config.php and add:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Step 3: Identify the source of the error
Check the debug log file at:
/wp-content/debug.log
Step 4: Check plugin compatibility
Deactivate all plugins except WooCommerce and reactivate them one by one to find the conflict.
Common WooCommerce error messages
These error messages come up particularly often:
"Fatal error: Cannot redeclare..."
This error occurs when a function is declared more than once. The cause is usually a conflict between plugins.
"Fatal error: Maximum execution time exceeded"
The PHP execution time limit is set too low. Increase it in php.ini:
max_execution_time = 300
Getting professional help
If you can't or would rather not fix the error yourself, we are happy to help. As a WordPress agency with 25 years of experience, we have already solved hundreds of cases like this.
Prevention: how to avoid fatal errors
- Create regular backups (daily is recommended)
- Test updates on a staging environment first
- Check plugin compatibility before updating
- Keep your PHP version up to date
- Only use trustworthy plugins
- Have regular maintenance carried out
Conclusion
A WordPress fatal error is annoying, but in most cases it can be fixed quickly. With the right approach and a little patience, you can usually repair your website yourself. For more complex cases, or if you want to be on the safe side, professional support is the better choice.