---

Documents

• 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 […]

• Email troubleshooting

  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. […]

• Troubleshooting Core Shipping

  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 […]

• Troubleshoot PHP errors

  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”

  May 6, 2025 Advisory: There was a known issue in WooCommerce core that can cause fatal errors on some sites using block themes. The issue was related to a malformed response from the Woo Block Patterns API, which may result in a bad cached value. How can I tell if this affects me? If your […]

• Troubleshoot AJAX issues

  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 […]

• Troubleshooting shortcodes

  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 […]

• Troubleshoot payment errors

  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 […]