Not sure where to start? Check out our Troubleshooting Guide to read about common issues and their solutions.
Documents
-
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. For a payment that times out […]
-
HTTP and response codes
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
If a customer receives the completed order email but it does not include download links, check the product files, order status, and download permissions first. These checks help you restore access and distinguish a download-access problem from an email customization. This guide covers the completed order email generated by WooCommerce core. An email builder, template […]
-
Finding PHP error logs
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)
This document explains how to resolve issues with product variations, tax rates, and other large data sets not saving in WooCommerce. These problems are typically caused by the max_input_vars PHP directive, servers running mod_security, or other server-level configuration limits. Follow the steps below to identify the cause and adjust your server configuration. The troubleshooting steps […]
-
Endless loading/spinner on the checkout page
If checkout stays dimmed behind a loading spinner, the browser is usually waiting for a request, rejecting its response, or unable to finish the JavaScript that updates checkout. The request and the best diagnostic steps depend on whether the page uses classic checkout or the Checkout block. You need store administrator access and a staging […]
-
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
Several premium WooCommerce shipping extensions use built-in box packers to determine which box or envelope best fits the items in an order. This guide explains how box packers work, how to configure product dimensions for accurate packing, and how to select or customize boxes. How box packers work Box packers evaluate the dimensions of available […]
-
WooCommerce pages not displaying
WooCommerce relies on specific pages to display the cart, checkout, and customer account. If these pages are missing, blank, or not displaying content correctly, there are several possible causes — from missing page assignments to permalink issues, caching problems, or plugin and theme conflicts. This guide helps you diagnose the issue and fix it. Possible […]