Quick answer
If WooCommerce is not working properly, the most common culprits are conflicts with other plugins or the theme, outdated permalink data, incorrect currency or country settings, caching showing old page versions, and insufficient server resources. The fix starts with disabling plugins and switching to a default theme, then refreshing permalinks and checking system status. If the problem occurs only at checkout, check payment gateway settings and the SSL certificate.
How to recognize the problem
- Product page not displaying or showing a 404 error
- Add to cart button not responding or cart remaining empty
- Payment failing, error message appearing
- Price or stock changes not visible on the site
- WooCommerce reporting errors in system status
Most common causes
Conflict with plugins or theme
Other plugins or the theme can override WooCommerce templates and cause display or functionality errors.
Incorrect permalinks
If the permalink structure changes or is not refreshed after installing WooCommerce, product and category pages may return 404.
Incorrect store settings
Incorrectly selected currency, country, or shipping zone can prevent checkout completion.
Caching old versions
Caching plugins, CDN, or browser cache can show outdated pages and hide changes.
Insufficient server resources
WooCommerce is demanding and can exceed memory or execution time limits, causing it to stop working.
Step-by-step fix
- 1
Make a backup
Before any changes, always make a complete backup of the site (files and database) using a backup plugin or hosting tool. This will allow you to restore the site to its previous state if something goes wrong.
- 2
Check WooCommerce system status
Go to
WooCommerce > Statusand review the system status data. Pay attention to red or yellow error messages about outdated templates, missing extensions, or database issues. You will often find the specific cause there. - 3
Disable all plugins except WooCommerce
Go to
Plugins > Installed Pluginsand deactivate all plugins except WooCommerce. Then check if the problem persists. If it disappears, reactivate plugins one by one and test until you find the culprit. - 4
Switch to a default theme
Go to
Appearance > Themesand temporarily activate one of the default themes (e.g., Twenty Twenty-Four). If the problem is resolved, the cause is in your theme or its customizations. After testing, restore the original theme. - 5
Refresh permalinks
Go to
Settings > Permalinksand simply clickSave Changeswithout changing any options. This refreshes the link structure and resolves most 404 errors on product and category pages. - 6
Check store settings
In
WooCommerce > Settings, check theGeneraltab (currency, country, address) and theShippingtab (zones and methods). Make sure the data is correct and all shipping zones are properly configured. - 7
Clear cache
Clear the caching plugin's cache (e.g., WP Rocket, LiteSpeed Cache) and the browser cache (Ctrl+F5). If you use a CDN, clear the CDN cache as well. Then test the store's behavior again.
- 8
Increase resource limits
In
wp-config.php, add or increasedefine('WP_MEMORY_LIMIT', '256M');anddefine('WP_MAX_MEMORY_LIMIT', '512M');. If you cannot access the file, contact your hosting provider to increase the PHP memory limit andmax_execution_time. - 9
Check SSL and payment gateways
Make sure the SSL certificate is valid and the site is accessible via HTTPS. In
WooCommerce > Settings > Payments, check that payment gateways are correctly configured and whether they are in test or production mode.
If nothing helps: advanced diagnostics
If you have tried everything above, enable WordPress debug mode in wp-config.php by setting define('WP_DEBUG', true);, define('WP_DEBUG_LOG', true);, and define('WP_DEBUG_DISPLAY', false);. Then reproduce the problem and review the wp-content/debug.log file for specific PHP errors. You will often find the name of the plugin or function causing the problem in the log. Also, check that all WooCommerce parts are updated to the latest version and that the templates in your theme are compatible (in the Templates section on the WooCommerce > Status page). If you use object caching (e.g., Redis), temporarily disable it and test. For deeper analysis of the database and slow queries, contact hosting support. After completing diagnostics, be sure to disable WP_DEBUG and remove or protect the debug.log file.
How to prevent it
- Regularly update WordPress, WooCommerce, theme, and plugins
- Test changes on a staging site before applying to production
- Maintain regular backups and verify their integrity
- Monitor WooCommerce system status and respond to warnings
When to call a professional
If the problem recurs and requires changes to the database, server, or payment integrations, it is better to contact IT support or your hosting provider to avoid permanent damage.
Website development · Fast, SEO-ready, multilingual websitesFAQ
Why are my products not showing on the site?
The most common reason is unrefreshed permalinks or a plugin conflict. Go to `Settings > Permalinks` and click `Save Changes`, then temporarily disable other plugins and check if products appear.
How do I fix a payment problem in WooCommerce?
Check that the SSL certificate is valid and that payment gateways are correctly set in `WooCommerce > Settings > Payments`. Make sure the API key details are correct and there is no conflict with a caching plugin.
Is it safe to deactivate all plugins?
Yes, temporarily deactivating plugins will not permanently damage the site, but some functions will be unavailable. Always make a backup before changes and reactivate plugins gradually.