The WordPress and WooCommerce combination offers one of the most widely used eCommerce and online shopping platform. Although it is very easy to set up, it is normal to occasionally encounter different kinds of errors.
If you are looking to fix an existing error on your WooCommerce store, then you have come to the right place. From plugins to server configurations, we will explain common errors, how they can be prevented, and what you can do to fix them.
- Common error categories
- Basic requirements and error fixes
- Email notification errors
- Server configuration errors
- PHP fatal errors
Common error categories
Most WooCommerce errors are known to occur when there are problems in any of the following aspects of the WooCommerce/WordPress system.
Email notification errors: In some cases, WooCommerce may not be able to send email notifications such as new orders, order information, etc.
Server configuration errors: This has to do with errors that occur when server configurations display some odd behaviors. Sometimes the hosting service providers may not have setup sessions properly.
WooCommerce/Wordpress setup and versions: Errors in this category usually occur because something in the system is outdated or was not properly set up.
Theme and plugins compatibility issues: There are themes that do not work well with certain plugins. For instance, the Storefront theme is particularly recommended for WooCommerce. But errors may occur when the theme selected is not compatible with the WooCommerce plugin.
PHP errors: When there wrong logic and syntax in the PHP code, a number of error messages will be displayed. Also, if the PHP version is not compatible with WooCommerce, you could begin to see errors such as failure of the payment system.
Plugin error and cross-plugin conflict: Plugins can be faulty in a number of ways, with faults ranging from missing hooks to missing files. When that happens, the plugin is bound to cause errors in the system. On the other hand, plugins occasionally interfere with one another’s functionality, thus leading to errors.
Basic requirements and common error fixes
- Update WordPress and WooCommerce to the latest versions. Read the article on Updating WordPress for better information.
- Make sure all plugins are regularly updated.
- Ensure theme compatibility.
- Remove faulty plugins. After disabling all plugins, you can later reactivate them one at a time to detect a faulty one. Here is how.
- Enable WP_DEBUG to log all the errors caused by WordPress plugins. You can do that by adding define( ‘WP_DEBUG’, true ); and define( ‘WP_DEBUG_LOG’, true ); lines of code to your “wp-config.php” file. This will create a “debug.log” file in wp-content folder.
Email notification errors
If you are not getting notified on customer orders, or your customers do not get email notifications after completing orders, then there’s very likely an issue with the email system in your web shots.
Fortunately, this is a straightforward fix. Learn how to solve it in this guide: How to fix email notifications in WooCommerce.
Server configuration errors
This refers to errors that occur when WooCommerce stores do not receive any response from the server. Sometimes it happens as a result of an internal server error.
404 Server Error: Not Found
This error usually happens when a link is broken, incorrect or nonexistent. You can fix this by editing your permalink settings.
Login to your admin dashboard and click Settings >> Permalinks and check the Post name radio button and Save Changes.
Important Note: Changing your Permalink structure will break all external links to your site as well as all search engine indexing. To fix this, you have to set up 301 redirects. You can do this quite easily with the Simple 301 Redirects Plugin.
500 Internal Server Error
Internal server error can be caused by a number of faults. But 2 common fixes are:
- Check if the .htaccess file is corrupt
- Upload new WordPress core files
Log into the remote site via FTP and locate the .htaccess file in the root folder of your WordPress setup.
Right -click on the file and rename it to something different. Having done that, log into your site again to see if the error still persists. If not, then you found your solution.
But if the .htaccess file was not corrupted, then the other solution is to upload new WordPress core files. Please read up on how to replace WordPress core files here.
503 Service unavailable
Service unavailable is a rather complicated error that happens when the server does not receive the right PHP responses. Before trying anything else, carry out the basic error fixes listed above. If the error is not resolved, then do the following:
- Switch to a default theme, and check if the 503 Service unavailable error is gone.
- Contact your web hosting provider as the last resort.
Error getting the remote image
The solution to this error is to contact your web hosting service providers to increase your server’s max-input-time from -1 to 36000.
Product error: You don’t have permission to access…
This error shows a 403 Forbidden. It means that you do not have valid permission to some files or a particular file. You may have to call your web hosting service to change the file permission settings for you.
PHP fatal errors
These are critical errors in PHP that immediately terminate the script. By default, the error is displayed to the user so it can be corrected.
Allowed memory size exhausted
The error indicates that a set memory limit on PHP has been exceeded. To increase it, you have to access the root folder of your remote site and look for the wp-config.php file.
Next, right click on it and select View/Edit to open in on your text editor.
Then add define( ‘WP_MEMORY_LIMIT’, ‘256M’ ); to it as shown in the image.
If the solution does not work, then you have to contact your host.
Maximum execution time exceeded
If you encounter this common fatal error, it may likely be the fault of a plugin. This means one of your plugins may be running a script that is taking too long to execute and you are running out of execution time. To solve this, you may have to adjust your website’s maximum execution time.
To do this, connect to your remote files via FTP. And just as in the earlier steps, locate and right-click on the .htaccess file and select View/Edit.
Open up the file in a notepad program and add this line of code to the bottom of the file’
php_value max_execution_time 300
The error should be fixed with that time increment. Learn more on our complete guide: How To Fix ‘Fatal Error: Maximum Execution Time Exceeded’ in WordPress.
There are times you will encounter errors you may not be able to fix, even after reading a detailed tutorial like this. If that ever happens, you can contact FixRunner’s WooCommerce Support team of WordPress experts who will readily provide the full site support you need.
But in the event of common errors, this article has shown you the most straightforward fixes that should solve your error issues. Learn more about WordPress errors on our Common WordPress errors article.