Not sure where to start? Check out our Troubleshooting Guide to read about common issues and their solutions.
Documents #
Get tailored help fast with Woo’s AI Assistant
Right here, right now, and (almost) always right WooCommerce.com’s AI support assistant isn’t your typical bot! Our AI-powered assistant searches our library of WooCommerce-related information to intelligently answer any type of question you may have as you use WooCommerce. WooCommerce’s AI support assistant is ideal for getting quick and detailed help with questions you have […]
WooCommerce self-service guide
WooCommerce troubleshooting and conflict testing are useful for finding out why your site is having problems. Have an issue with your WooCommerce store? We aim to help you solve it. Most common issues Most issues are caused by: Outdated software Keeping software up to date helps protect your website against hacking. The latest versions of […]
Troubleshooting using Health Check
The Health Check & Troubleshooting plugin is useful for troubleshooting problems on your WooCommerce site, particularly those related to plugin and/or theme conflicts. It allows you to do several tests in a browser session, without affecting visitors to your live site. However, keep in mind that, given a particular combination of plugins, themes, and hosting […]
In some cases, issues can arise that prevent your WooCommerce store from sending emails, or your shoppers from receiving them. This guide aims to tackle common email problems related to WooCommerce stores, with clear steps to diagnose and resolve these issues. By default, WooCommerce sends mail using the wp_mail() function, a core function of WordPress. […]
Last updated July 18, 2025. This guide helps store owners resolve problems with built-in shipping features in WooCommerce. Use the steps below to troubleshoot incorrect rates, missing methods, or unexpected checkout behavior. What this guide covers This guide focuses on issues with shipping options included in WooCommerce core: The guide also provides guidance on where […]
PHP is a popular scripting language that powers many websites, including those created with WordPress. It runs on your web hosting server and allows your website to perform complex functions — such as processing form submissions, managing user sessions, and interacting with databases. How to find PHP errors To find PHP errors on your WordPress site, […]
Troubleshoot “My site is down”
WordPress sites occasionally go down; this guide is meant to help you get started with troubleshooting. This is when your site can no longer load or respond properly to requests due to an error. How do I know if my site is down? You may be seeing any of the following: How do I troubleshoot my […]
Asynchronous JavaScript and XML (AJAX) is a web development technique used to create interactive web applications. With AJAX, web applications can send and retrieve data from a server in the background without disrupting the display and behavior of the current page. This means parts of a web page can be updated without needing to reload […]
On this page, you’ll find a few common reasons why WooCommerce shortcodes may not work as expected. Shortcodes cannot be embedded between <pre> tags If your shortcodes are correctly pasted but display incorrectly, ensure they are not enclosed between <pre> tags. To remove these tags, edit the page, and click the Text tab: Incorrect quotation […]
Troubleshoot JavaScript errors
JavaScript errors can interfere with essential WooCommerce functions like product displays, checkout, and form submissions. This guide shows you where to find these errors and how to troubleshoot them. What is JavaScript? JavaScript is a programming language that runs directly in the browser, not on the server. This allows it to respond quickly to user […]
Troubleshooting payment errors can depend on the payment gateway you are using and how it is set up or might be specific to your site or customer. WooCommerce comes with a number of built-in payment options and you can also see the payment gateways available in the WooCommerce.com Marketplace. Common errors and their causes When […]
When managing a website, understanding HTTP and response codes is helpful for ensuring your site runs smoothly. HTTP (HyperText Transfer Protocol) forms the backbone of how users and sites communicate data over the web. Whether you’re browsing a website or managing your own, every interaction on the internet involves HTTP requests and responses. HTTP codes […]
Completed Order Email doesn’t Contain Download Links
On some WooCommerce installs you can experience the following issue: when a customer purchases a downloadable product, the Complete Order Email doesn’t contain any download link for the customer to download purchased products. Here is how the email looks like in that case: While it should look like this: Missing SQL Table This happens because a […]
PHP error logs can be useful when investigating an issue with a WordPress and WooCommerce site. This guide will provide steps and information about how to access PHP error logs within WooCommerce or on a hosting server. WooCommerce logs WooCommerce features a logging system accessible in WP Admin via WooCommerce > Status > Logs, which […]
Problems with large amounts of data not saving (variations, rates etc)
If you notice product variations, tax rates and other large data sets not saving, Suhosin (a security module in PHP) may be preventing the POST data from being saved. This issue can also be caused by servers with version PHP 5.3.9+ and servers running mod_security. Configuring Suhosin If enabled, Suhosin may need to be configured […]
Endless loading/spinner on the checkout page
The ‘review order’ page loads the payment methods/totals via AJAX – this display a loading spinner briefly. If there are problems, this section may fail to load or the spinner may remain. First, you should check WooCommerce > Status for errors – often errors will be highlighted. Common causes and resolutions are listed below. AJAX […]
jQuery.cookie.js/jQuery.cookie.min.js scripts fail to load
This is a problem with the server-setting, meaning that your hosting company will need to solve this on your behalf. The problem is outdated MOD_SECURITY core ruleset. Option 1: Get your host to update the rule set This is by far the best option as everything will then work as by design. Contact your hosting […]
Cross-browser testing your site
Testing your WooCommerce website across multiple browsers is essential to ensure a seamless shopping experience for your users, regardless of their preferred device, browser, or location. By conducting cross-browser testing, you can identify and resolve compatibility issues that may affect the functionality, appearance, or usability of your site. Why is cross-browser testing important? Different browsers […]
Understanding Box Packing Calculations
Many of our premium shipping methods, especially those that calculation shipping costs via the carrier’s API, have built-in Box Packers that determine which box or envelope is the best fit for all the items being purchased. How Box Packers work: Box Packers look at the dimensions of available boxes/envelopes (using the “Inner” dimensions, if specified) […]
Online Shipping Calculators & Debug Mode
If shipping costs provided by your WooCommerce installation are higher or lower than what you expect, we recommend enabling the debug mode within the shipping plugin settings section that you are using. Once this option is enabled, add a product to cart and in most cases you will see useful information on the cart page […]
WooCommerce pages not displaying
If you are having trouble with WooCommerce pages not installing or displaying content correctly, here’s how you can fix this: Note: This document does not cover every imaginable case. We recommend reviewing our troubleshooting guide to determine whether there is a conflict on your site. WooCommerce pages updated to endpoints Before WooCommerce 2.1, individual pages […]
How to test for plugin and theme conflicts
What are theme and plugin conflicts? A conflict is an error or malfunction caused by two parts of code giving conflicting signals. For example, plugin A gives the signal to put the order in “Completed” status and plugin B prevents this from happening. Themes and plugins provide additional functionality and features — it also means […]
This document is for anyone who has received an email from PayPal with the subject : IMMEDIATE ATTENTION REQUIRED: PayPal service upgrades PayPal is upgrading the certificate for www.paypal.com to SHA-256. This endpoint is also used by merchants using the Instant Payment Notification (IPN) product. The WooCommerce PayPal Standard Gateway itself requires no changes. You […]
Installation and Configuration: Upon installation, WooCommerce creates the following new pages via the Setup Wizard: How can I add a shortcode if I am using the block editor? To add the shortcode to a page with the Block Editor, please use the Shortcode Block, enter the shortcode and save the page. Re-install Pages or Install […]
HTTP 500 Internal Server Error — getting more information
An HTTP 500 Internal Server Error is a commonly encountered error. It is often temporary and is a general server error response. Error message Generally, an HTTP 500 Internal Server Error’s output is not descriptive and does not help narrow down the cause of the issue. It is considered best practice to show a generic error […]
Multiple installs on one domain + SESSIONS (conflict/session sharing workaround)
If you are running multiple installs of WordPress on the same domain, and SESSIONS are being shared between your installs you can add the following to your wp-config.php file to prevent this from occurring: if ( ! session_id() ) { session_name( ‘PHPSESSID_1' ); } You can change the name to something unique for each install.
The majority of blurry product image issues are caused by theme styling, where the design of the theme specifies image dimensions that may not play nicely with WooCommerce. Note: Anytime a new theme is activated or image dimension settings are changed, previously-created thumbnails will need to be regenerated. To do so via your WP Admin […]
If you get errors like this in your site header: Warning: session_start() [function.session-start]: open(xxx) failed: Permission denied (13) in xxx/wp-content/plugins/woocommerce/woocommerce.php on line 80 your server is to blame. PHP Sessions may not be set up correctly, or the sessions directory (usually /tmp) is not writable. You need to contact your hosting provider to resolve this.
Increasing the WordPress memory limit
There are two ways to address memory limit issues in WordPress: Do it yourself Below, you’ll find several methods for adjusting WordPress memory limits yourself. Note: This section requires advanced knowledge. Edit your wp-config.php file Add the following code snippet to the top of your site’s wp-config.php file: define(‘WP_MEMORY_LIMIT’, ‘256M’); This code snippet should be added […]
This document gives an overview of the Secure Sockets Layer (SSL) and Hypertext Transfer Protocol Secure (HTTPS), explaining their importance for securing your WooCommerce store. You’ll learn how to set up a free or paid SSL certificate on your site, and why they are essential for protecting customer data and boosting trust. Our aim with […]
This document contains troubleshooting suggestions for issues related to taxes in WooCommerce. What this guide covers The WooCommerce plugin includes support for basic tax rates. These built-in tax options are referred to as Core Taxes. Using Core Taxes, you can set up basic tax options under WooCommerce > Settings on the “Tax” tab, and also […]
SSL by proxy problems (Network Solutions)
Hosts that insist on SSL by proxy, such as Network Solutions), will cause problems with WordPress and WooCommerce because they prevent PHP and the WordPress is_ssl() function from detecting if the page is being served over HTTPS. This causes a redirect loop. In Network Solutions’ own words: Network Solutions® uses a proxy SSL; this does not allow the […]
This error: SSL received a record that exceeded the maximum permissible length. (Error code: ssl_error_rx_record_too_long) is caused by a misconfiguration of SSL/apache (commonly port settings and VirtualHost settings). In most cases the hosting provider, or server administrator, will need to fix the problem (it is not a WooCommerce issue). If you don’t need SSL you […]
Fatal error: Call to undefined function is_woocommerce_active()
Currently, we are aware of two possible causes for receiving the following error: Outdated extensions First, check the Subscriptions page in your WooCommerce.com account dashboard to see whether all of your extensions are up to date (including WooSlider if you have it installed). If you have activated your keys, then you will receive automatic update notifications. […]
