Woocommerce
Products
Last Updated: 18/03/2026Categories Adding and managing products Adding and Managing Products See all topics Documents Product brands Brands in WooCommerce offer an additional and helpful way to create brands for your shop, with a name, description, and image assigned to each. Setup and configuration Creating brands To start adding brands: Editing and deleting brands Modify Brands by...
Adding and Managing Products
Last Updated: 19/03/2026Before you can start selling, you need products to offer. That’s why adding and managing your inventory is a crucial step in setting up your shop. Getting Started with Product Management in WooCommerce In WooCommerce, you can add a product with just a name and a price. However, the more details you provide, the more...
Product brands
Last Updated: 19/03/2026Brands in WooCommerce offer an additional and helpful way to create brands for your shop, with a name, description, and image assigned to each. Setup and configuration Creating brands To start adding brands: Editing and deleting brands Modify Brands by hovering over the Name and click Edit or Delete. Brands may also be re-ordered by dragging and dropping. Assigning a...
Set up Related Products, Up-Sells and Cross-Sells
Last Updated: 19/03/2026Products can be Related to each other in three ways: Up-Sells, Cross-Sells or by having the same tags or categories. To add an up-sell or cross-sell to a product: Note: related products, up-sells and cross-sells are all sorted randomly. Up-Sells Up-sells are products that you recommend instead of the currently viewed product. They are typically products that are more...
How to Add a WooCommerce Product
Last Updated: 19/03/2026To sell on WooCommerce, you need to add products, and you just need a product name and a price to begin. On this page, you’ll learn how to add the various types of core WooCommerce products. Adding a Simple product Let’s add a Simple product. You’ll need: The following example results in a basic product...
Adding Product Images and Galleries
Last Updated: 19/03/2026Product images and galleries are used to showcase your products to customers. Images build customer confidence, make the product presentation visually appealing, and help to drive sales by enticing visitors in external locations like search engines and social media where the images are displayed. On this page you’ll learn: Types of product images Images are measured...
Variable Products
Last Updated: 19/03/2026Variable products in WooCommerce let you offer a set of different options on a product, with control over prices, stock, image, and more for each variation. You can use them for a product like a t-shirt, which you can offer in large, medium, and small sizes, all in different colors. On this page you’ll learn: Adding a Variable...
Virtual and downloadable products
Last Updated: 19/03/2026On this page, you’ll learn how to add and configure both virtual and downloadable products. When a product is virtual and/or downloadable, it means that the item: These settings are useful for intangible products (such as services or an album) which might include both delivery and download options. Making a product virtual When adding a simple product,...
Digital/Downloadable Product Guide
Last Updated: 19/03/2026While the default downloadable product settings work for most Woo merchants, some merchants may find that they need a different configuration. This page guides you through the different downloadable product configurations to help you find one that fits your needs. On this page you’ll learn: Digital/Downloadable Products: General Settings Note: If you selected either Force...
Product Reviews
Last Updated: 19/03/2026Product reviews are a powerful tool for online conversions and establishing loyal relationships with your customers. WooCommerce allows customers to create reviews with star ratings and for the shop owner to moderate and reply to customer reviews. Studies show that a product review, or a recommendation from another shopper, has a large effect on a customer’s...
WooCommerce Product Editor settings
Last Updated: 19/03/2026Every product in your store can be edited at any time to update pricing, description, imagery, etc. On this page, you’ll learn about each of the settings in the product editor and how to edit each one. Which settings are in the WooCommerce Product Editor? The Product Editor can be found by navigating to Products >...
Product Shipping Classes
Last Updated: 19/03/2026Shipping classes utilize a product classification system to group products of similar type (e.g. bulky products or small items). Shipping classes work with shipping methods, such as Flat Rate Shipping, to provide different rates to different classes or types of products. For example, with shipping classes and Flat Rate Shipping, it’s possible to create different flat...
Custom Fields on Products
Last Updated: 19/03/2026WooCommerce offers the capability to enhance your product listings with custom fields, a feature that allows you to display additional product details to customers. Custom fields are additional metadata of your products, which can be utilized in various ways within your theme or site to display extra information, tailor the shopping experience, or provide specific product details...
Product Category Shortcodes
Last Updated: 19/03/2026These two shortcodes will display your product categories on any page. Available Product Category attributes Examples of Product Category Scenarios Show Top Level Categories Only Imagine you only wanted to show top level categories on a page and exclude the sub categories, well it’s possible with the following shortcode. Questions and support Do you still...
Managing Product Categories, Tags and Attributes
Last Updated: 19/03/2026Product categories, tags, and attributes are different ways you can use to organize, display, and filter products in your WooCommerce store. Being technical, you would call these product taxonomies. Though their uses overlap a bit, each one serves a slightly different purpose. In this document we’ll explore these three fundamental taxonomies for organizing and managing...
Product shortcodes
Last Updated: 19/03/2026While WooCommerce primarily uses blocks to offer interactive and customizable display settings for products, you can still use legacy product shortcodes on your store by adding them to a shortcode block. This document lists and explains the available WooCommerce product-related shortcodes. Note:The core WooCommerce plugin includes several product blocks which can be more powerful and flexible compared to shortcodes, learn...
Product CSV Importer and Exporter
Last Updated: 19/03/2026The CSV import and export tool in WooCommerce is a powerful feature designed to streamline the management of your online store’s product and customer data. This tool allows store owners to easily import large volumes of products in bulk, including their attributes, categories, and images, directly into WooCommerce using a CSV file. Additionally, it supports...
Migrating products between sites
Last Updated: 19/03/2026Data portability is a fundamental advantage of platforms like WooCommerce and WordPress, WooCommerce empowers merchants to fully own and control their data. This ensures that you can freely transfer and utilize your data across different systems as needed. In the context of this documentation, we’ll cover some options for exporting and migrating WooCommerce products. How...
Duplicate or delete a product
Last Updated: 19/03/2026As your business evolves, you may find it necessary to delete certain products and duplicate others to quickly add more with similar settings. On this page, you’ll learn how to duplicate products or delete them entirely from your WooCommerce store. Duplicating a product Duplicating existing products can be a huge time-saver. You can use an...
Feature, Filter, and Sort Products
Last Updated: 19/03/2026There are several default ways in which you can arrange and present products to your customers to highlight the ones you feel need the most attention. On this page you’ll learn: Mark a product as Featured To mark a product as featured, go to Products > All Products and select the Star in the featured column. Alternatively, select Quick Edit and...
Bulk Editing Products
Last Updated: 19/03/2026Much like WordPress’ other post types that let you assign categories, tags or post statuses en masse, WooCommerce products also have a bulk editing feature. This document covers the bulk editing options for WooCommerce products accessible from the Products list screen. Refer to built-in product CSV importer and exporter for an alternative bulk edit approach that can...
Fixing blurry product images
Last Updated: 19/03/2026The 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 dashboard, navigate to WooCommerce...
Find Product Category IDs
Last Updated: 19/03/2026Some WooCommerce shortcodes ask for the category ID to display a list of categories. This document shows how you can locate the ID for your product categories. More info at Shortcodes included with WooCommerce. Better yet, consider using the blocks included in WooCommerce alongside a theme that supports full site editing. To find the product category ID: Finding...
Adding and managing products
Last Updated: 19/03/2026Documents Adding and Managing Products Before you can start selling, you need products to offer. That’s why adding and managing your inventory is a crucial step in setting up your shop. Getting Started with Product Management in WooCommerce In WooCommerce, you can add a product with just a name and a price. However, the more...
Taxes
Last Updated: 19/03/2026Documents Setting Up EU VAT Rates for Digital Products VAT Updates starting in 2026: Several European countries are updating their tax rules in the new year, most taking effect on January 1: To learn about these changes and how to prepare your Woo store, check our blog post: Prepare your business for 2026 EU tax...
Setting Up EU VAT Rates for Digital Products
Last Updated: 19/03/2026VAT Updates starting in 2026: Several European countries are updating their tax rules in the new year, most taking effect on January 1: To learn about these changes and how to prepare your Woo store, check our blog post: Prepare your business for 2026 EU tax change EU VAT laws for digital goods changed on 1 January...
EU VAT July 2021 changes, ecommerce, and WooCommerce
Last Updated: 19/03/2026Overview On July 1, 2021, the European Union (EU) introduced new regulations related to value-added tax (VAT). Merchants selling across borders within the EU or importing to the EU will need to comply. In this documentation we will provide key changes and scenarios for the new changes, although this is not exhaustive. We will use...
How to handle multiple regions and currencies with WooCommerce
Last Updated: 19/03/2026In a global age, very few store owners only sell to one region, with one language and one currency. Several different things play a role, and below we’ll discuss several of those. What you want to offer Solution Links Multiple taxes and shipping zones WooCommerce core Download Multiple currencies Currency Converter Widget Purchase Multiple languages...
Setting up taxes in WooCommerce
Last Updated: 19/03/2026Setting up taxes is one of the first tasks you will want to complete when setting up a store. In this guide, we look at available options for how to set up taxes in WooCommerce, how to access them, and what the WooCommerce tax settings do. This documentation covers how to set up tax rates...
How Taxes Work in WooCommerce
Last Updated: 19/03/2026There are more challenging tax configurations where an understanding of how taxes work in WooCommerce help with configuration and troubleshooting. Let’s take a look at a few nuances. Related guides for additional reference: Defining Prices Product prices can be defined as either: When we say defined including tax, we are referring to the taxes of the store’s base...
How to configure specific tax setups in WooCommerce
Last Updated: 19/03/2026The tax scenarios in this document are step-by-step guides that show how to configure specific tax setups in WooCommerce. They provide all the steps needed to achieve a particular outcome but without going into detail. Due to the uniqueness and variety of stores out there, the scenarios are not exhaustive and for illustration purposes only....
Troubleshooting Core Taxes
Last Updated: 19/03/2026This 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 use this section to set up...
Shipping
Last Updated: 19/03/2026Categories Core Shipping Options Flat Rate Shipping Free Shipping Local Pickup See all topics Documents Setting up Shipping Zones If you sell physical products on your WooCommerce store, you need to configure shipping zones. Shipping Zones are the foundation for most shipping options/configurations in WooCommerce. How you configure your shipping zones determines the shipping options...
Setting up Shipping Zones
Last Updated: 19/03/2026If you sell physical products on your WooCommerce store, you need to configure shipping zones. Shipping Zones are the foundation for most shipping options/configurations in WooCommerce. How you configure your shipping zones determines the shipping options and rates customers see on the cart and checkout pages. This page outlines three steps to configure shipping zones...
Offer Shipping Insurance
Last Updated: 19/03/2026In WooCommerce and its native shipping options, there is not a built-in way to offer insurance for goods you are shipping. Include in product price One option is to include the insurance cost in the price of your products. This, however, has the downside that it gives customers the wrong impression on actual cost of...
Consider shipping before you start
Last Updated: 19/03/2026Considering shipping before you start is important for setting up shipping correctly before taking orders in your WooCommerce store. If you are new to WooCommerce, we recommend taking some time to answer the following questions. The questions and topics below help you understand what you might need to use in or add to your store....
Understanding Box Packing Calculations
Last Updated: 19/03/2026Many 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
Last Updated: 19/03/2026If 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...
Core Shipping Options
Last Updated: 19/03/2026Documents Flat Rate Shipping Flat Rate Shipping is a shipping method included in WooCommerce that allows you to define a standard shipping rate per item, per shipping class, or per order. On this page you’ll learn how to: Standard Flat Rates: Setup and Configuration 5. Enter a Name that displays to customers in the cart...
Flat Rate Shipping
Last Updated: 19/03/2026Flat Rate Shipping is a shipping method included in WooCommerce that allows you to define a standard shipping rate per item, per shipping class, or per order. On this page you’ll learn how to: Standard Flat Rates: Setup and Configuration Note:This shipping method has to be added to a Shipping zone. If you haven’t configured your...
Free Shipping
Last Updated: 19/03/2026Free shipping is a WooCommerce core shipping method that allows you to add a “free shipping” option for customer orders if they either meet certain criteria (e.g. a minimum order spend amount) or if you want to offer free shipping to all customers within a certain geographical area. On this page you’ll learn how to: ...
Local Pickup
Last Updated: 19/03/2026Note:This document is referring to the legacy WooCommerce local pickup options. If you’re using a WooCommerce Blocks-based checkout, you can find configuration instructions for the local pickup block here. Local Pickup is a WooCommerce core shipping method that allows the customer to pick up an order themselves. On this page, you’ll learn how to: Local Pickup:...
Troubleshooting Core Shipping
Last Updated: 19/03/2026Last 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...
Shipping Method API
Last Updated: 19/03/2026WooCommerce has a shipping method API which plugins can use to add their own rates. This article will take you through the steps to creating a new shipping method and interacting with the API. Learn more about the Shipping Method API in the WooCommerce Developer Documenation. Questions and support Do you still have questions and need assistance? This...
Payments
Last Updated: 19/03/2026Documents Direct Bank Transfer (BACS) Direct Bank Transfer is a payment gateway that lets customers check out without making an online payment. Cash on Delivery Cash on Delivery (COD) is a payment gateway that allows a customer to make payment only when their order is delivered. Which payment option is right for me? There is...
Direct Bank Transfer (BACS)
Last Updated: 19/03/2026Direct Bank Transfer, which might also be referred to as Bank Account Clearing System (BACS), is a payment method that lets your customers pay you directly via their bank account. This is an offline payment method, meaning that the payment process is manual and happens outside your WooCommerce powered store. It’s important to be clear...
Cash on Delivery
Last Updated: 19/03/2026Cash on Delivery (COD) is a payment gateway that lets you take payments at the time of delivery of your customer’s ordered products. WooCommerce sets orders using Cash on Delivery (COD) to “Processing” until payment is collected. You, as the store owner, should confirm that payments for Cash on Delivery orders have been collected before...
Which payment option is right for me?
Last Updated: 19/03/2026There is a large range of payment gateway options for WooCommerce to provide payment options for your customers. Read on to learn about how to choose a payment method, including WooPayments (available in selected locations). On this page you’ll learn: What is a payment gateway? A payment gateway, in WooCommerce terms, is a WordPress plugin that enables WooCommerce to connect...
Check Payments
Last Updated: 19/03/2026Check payments is a payment gateway that lets customers make payments without needing to do it online. Until payment clears outside of WooCommerce (requiring the store owner to manually check their bank account), orders using Check payments remain in “on hold” status. You, as the store owner, should confirm that payments have cleared in your...
Check if a Payment Method Support Refund, Subscriptions or Pre-orders
Last Updated: 19/03/2026Payment methods can add support for certain features from WooCommerce and its extensions. For example, a payment method can support refunds, subscriptions or pre-orders functionality. If the payment method documentation doesn’t clearly outline the supported features, you can often find what features are supported by looking at payment methods code. Learn more about how to determine a gateway’s payment method support through...
Managing Payment Disputes
Last Updated: 19/03/2026Payment disputes are one of the more challenging aspects of running an online store. Let’s have a look at a few best practices for how to increase your chances of success when approaching and challenging disputes: What is a payment dispute? A payment dispute is when a customer’s card issuer comes back to you, the...
Paypal Update for SHA-256
Last Updated: 19/03/2026This 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...
How do I prevent and respond to card testing attacks?
Last Updated: 19/03/2026Under attack? See this section for how to respond to card testing. Card testing is a type of fraud where the someone obtains a large amount of stolen credit card data, and then attempts to determine which of those cards are valid. Typically, these fraudulent attempts involve making a multiple low-value purchases, each with a different card, to...
Orders
Last Updated: 19/03/2026Documents Refunding Orders in WooCommerce In any business, at times you’ll need to refund your customers. With WooCommerce, you can quickly process refunds in two ways: Automatically or Manually. Automatic refunds When processing refunds automatically, the order in WooCommerce has its status changed to “Refunded”, and the customer is refunded their money via the same...
Refunding Orders in WooCommerce
Last Updated: 19/03/2026In any business, at times you’ll need to refund your customers. With WooCommerce, you can quickly process refunds in two ways: Automatically or Manually. Note: Directly changing an order’s status to Cancelled or Refunded will not automatically refund your customer. Be sure to complete the refund process outlined below. Automatic refunds When processing refunds automatically, the order in WooCommerce has...
Removing personal data from orders
Last Updated: 19/03/2026WooCommerce has several settings that allow you to remove customer data from orders: Remove personal data using bulk editing Once this option is activated, you can use bulk editing to manually anonymize many orders at once. To enable this option: The option to remove personal data will then be available for orders. Once personal data...
Order Statuses
Last Updated: 19/03/2026Every order has its current state marked by a status. Order statuses can provide valuable information about the state of an order at a glance. The video and table below provide an overview and more details about order statuses in WooCommerce Order Statuses in WooCommerce Order statuses let you know how far along the order is,...
Orders Overview and Bulk Order Management
Last Updated: 19/03/2026The Orders page found at WooCommerce > Orders displays a list of your store’s orders, which fills up as customers start making purchases in your shop. This page is a central location for finding and managing your shop’s orders. This document explains: Orders Overview When a shop starts taking orders, they can be found on the Orders admin page. Navigate to WooCommerce...
Single Order Page and Manually Adding an Order
Last Updated: 19/03/2026The single order page in WooCommerce gives you a detailed view of an order made by a customer on your store. Admins and shop managers can also add and edit orders from this page. This document explains: Viewing and Editing a Single Order From the Single Order page, you can view edit, and update order data. Some...
Paying for Orders
Last Updated: 19/03/2026Taking payment for an order is an important step where many pieces come together to offer your shoppers a shoppers a smooth, easy experience that is also secure and promotes customer privacy. In WooCommerce, each order can only accept one payment. Orders can be paid in a several different ways: Below we’ll explore the details...
Managing orders
Last Updated: 19/03/2026Orders are the center of activity in your store. Understanding how to manage them effectively is key to keeping your business running smoothly. The following documentation is your guide to managing orders in WooCommerce. It is designed to assist administrators and shop managers in navigating through the various aspects of order management. Orders are visible...
Testing orders
Last Updated: 19/03/2026Creating test orders is an effective way to evaluate a new payment method, review your checkout process, and assess other order-related integrations. They can also be useful for troubleshooting issues. Like regular orders, test orders can trigger order emails and appear in WooCommerce analytics, among others. Many payment gateways offer a sandbox or testing mode...
Troubleshooting Orders
Last Updated: 19/03/2026Order-related challenges in WooCommerce, such as pending payments, inventory mismanagement, or incorrect order statuses, can disrupt your store’s functionality and customer experience. This guide simplifies the troubleshooting process, helping you identify common issues such as orders stuck in “Processing” or “On Hold” status, duplicate orders, or stock discrepancies. Order Status Issues If you are not...
Creating WooCommerce add-to-cart URLs
Last Updated: 19/03/2026Below, we’ll cover how to create specific, clickable links that add a product(s) to your customer’s cart via custom URLs. Using this URL or link, you can add items to the cart, specify the quantity, and even redirect to another page. Finding your product ID Add-to-cart URLs require the WooCommerce product ID to work. You...
Creating Sharable Checkout URLs in WooCommerce
Last Updated: 19/03/2026Sharable Checkout URLs make it easier to share ready-to-buy bundles with a coupon code through email campaigns, social media, or landing pages. Below, we’ll cover how to create custom links that automatically add specific products and coupons to the cart then, redirect customers to the checkout page. You can include simple products with no additional...
Data and reporting
Last Updated: 19/03/2026Documents Analytics and Sales Reports The Analytics and Sales Reports offer nine reports along with advanced filtering and segmenting tools, the ability to download data to CSV, and a customizable dashboard to monitor key metrics of your store. Since there is a great deal of functionality in the Analytics and Sales Reports, you can refer...
Analytics and Sales Reports
Last Updated: 19/03/2026The Analytics and Sales Reports offer nine reports along with advanced filtering and segmenting tools, the ability to download data to CSV, and a customizable dashboard to monitor key metrics of your store. Since there is a great deal of functionality in the Analytics and Sales Reports, you can refer to the Table of Contents...
Dashboard Widgets
Last Updated: 19/03/2026The WordPress dashboard is typically the first thing you see after logging in. Upon activation, WooCommerce will add two dashboard widgets giving you access to an overview of your store. If you’re using WordPress Multisite with multiple stores, a third widget will be added to the main site. To customize the widgets displayed on the dashboard, select “Screen...
WooCommerce Analytics: Order Attribution Report
Last Updated: 19/03/2026Early Access/Beta ReleaseThis extension is currently in an early access (beta) stage, which means we’re actively working to improve it based on your feedback. While we strive to provide a seamless experience, please note that some features may still be under development, and occasional bugs may occur. This extension is designed for single-currency stores only....
WooCommerce Reports
Last Updated: 19/03/2026WooCommerce Reports are legacy tools.With the release of WooCommerce 4.0 in March 2020, these reports are deprecated and won’t receive further updates. For detailed, accurate sales data (filters, segments, CSV exports, dashboards), use the new and improved Analytics section (available in WordPress 5.3+ in WooCommerce → Analytics). Learn more in the WooCommerce Analytics documentation. Reports in WooCommerce give you...
Customers
Last Updated: 19/03/2026Documents Accounts and Privacy Settings Clicking on the Accounts and Privacy tab at the top of the WooCommerce > Settings page takes you to the accounts and privacy Settings. These settings are where you can enable or disable guest checkout, control customer account creation, decide how personal data is retained or removed from your shop,...
Accounts and Privacy Settings
Last Updated: 19/03/2026Clicking on the Accounts and Privacy tab at the top of the WooCommerce > Settings page takes you to the accounts and privacy Settings. These settings are where you can enable or disable guest checkout, control customer account creation, decide how personal data is retained or removed from your shop, and set your privacy policy notices. Sections include: Additionally,...
The My account page
Last Updated: 19/03/2026Overview Customers who have an account with your store have access to My account — the central customer dashboard in a WooCommerce store. Here, customers can view past orders, and edit addresses and payment details. This guide provides an overview of what your customers can do via their account dashboard. Dashboard If a customer visits the My account page...
Marketing
Last Updated: 19/03/2026Documents Managing Coupons in WooCommerce Coupons: Overview WooCommerce comes with built-in coupon creation and management tools. WooCommerce core offers fixed-cart, fixed-product, and percentage-based coupons. On this page, you’ll learn how to: Activating Coupons in WooCommerce Before creating your first coupon, you’ll need to enable coupon use in your store. Enable coupons by following these instructions:...
Managing Coupons in WooCommerce
Last Updated: 19/03/2026Coupons: Overview WooCommerce comes with built-in coupon creation and management tools. WooCommerce core offers fixed-cart, fixed-product, and percentage-based coupons. On this page, you’ll learn how to: Activating Coupons in WooCommerce Before creating your first coupon, you’ll need to enable coupon use in your store. Enable coupons by following these instructions: (More info at: Configuring WooCommerce – General...
Google for WooCommerce
Last Updated: 19/03/2026Google Consent Mode Google introduced Consent Mode in March 2024 to comply with privacy laws in the EEA/UK region. This means website visitors from these regions must now explicitly grant consent for cookies before any analytics tracking occurs. Without consent, Google Analytics (GA4) and Google Ads won’t capture user data in these locations. The extension does not...
Email troubleshooting
Last Updated: 19/03/2026In 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. This means that...
Email Settings
Last Updated: 19/03/2026WooCommerce has a variety of built-in emails to help communicate your store’s operations. This guide provides a detailed overview of the email settings in WooCommerce, including: Find these settings on your site at: WooCommerce > Settings > Emails. Email Notifications For each WooCommerce email listed, it’s possible to configure your settings (optional). More detailed instructions below...
Site administration
Last Updated: 19/03/2026Categories Documents Email Settings WooCommerce has a variety of built-in emails to help communicate your store’s operations. This guide provides a detailed overview of the email settings in WooCommerce, including: Find these settings on your site at: WooCommerce > Settings > Emails. Email Notifications For each WooCommerce email listed, it’s possible to configure your settings...
Customizing WooCommerce: Best Practices
Last Updated: 19/03/2026The best thing about WordPress and WooCommerce is code and content can be changed to suit — modify and customize your website entirely. Flexibility is one of the greatest benefits to using WooCommerce to sell online. Plugins, extensions and themes can be used to fulfill requirements, then adjusted and coded to tailor the look and...
Updating free WooCommerce extensions/plugins
Last Updated: 19/03/2026Free WooCommerce extensions or plugins do not require an active subscription to get updates. You may see subscriptions for free extensions or plugins listed in your store’s WP Admin dashboard at WooCommerce > Extensions > My subscriptions. However, they will not have a toggle to activate a subscription. To update these free extensions/plugins via WP Admin, navigate to Plugins and update...
Accessibility Features in the WooCommerce Plugin
Last Updated: 19/03/2026Overview WooCommerce is built on top of WordPress, which adheres to strict accessibility coding standards. The WooCommerce plugin inherits these practices and introduces its own accessibility features to ensure compatibility with assistive technologies such as screen readers and keyboard-only navigation. This page outlines the built-in accessibility features within the plugin. Note: Many regions legally require ecommerce...
Understanding the WooCommerce System Status Report
Last Updated: 19/03/2026The WooCommerce System Status report is useful for troubleshooting issues with your store. Containing a wide variety of information and tools, you can check software versions, server settings, and more from within. System Status We encourage you to use the info below, before opening a support request with Woo Support. But we’re here to help...
WooCommerce Menu Items
Last Updated: 19/03/2026Activating WooCommerce adds 4 main menu items to the WordPress admin dashboard. These are the WooCommerce, Products, Analytics, and Marketing menu items. WooCommerce menu The main top-level WooCommerce menu item is the gateway to the most-used functions of your store. It includes a dashboard overview in Home, links to orders and customers, settings, store status, and extensions purchased from WooCommerce.com....
WooCommerce System Tools
Last Updated: 19/03/2026WooCommerce includes a set of built-in tools to help troubleshoot issues, optimize performance, and manage key settings in one place. The WooCommerce system tools, including database cleanup and clearing your site’s cache, can help WooCommerce run smoothly. You can access these settings from WooCommerce > Status > Tools. What Are Transients? A transient is a type...
Permalinks
Last Updated: 19/03/2026Permalink is short for permanent link. Permalinks are the URL structures used to help organize the content of your website which can be pages, posts, or, in the case of WooCommerce, products. A good URL structure can be efficiently navigated, shared, and referenced by potential customers and search engine crawlers. On this page you’ll learn: Taxonomy Permalinks...
WooCommerce Cookies
Last Updated: 19/03/2026A summary on cookies, and how WooCommerce uses cookies. What are cookies? Cookies are small pieces of data, stored in text files, that are stored on your computer or other device when websites are loaded in a browser. They are widely used to ‘remember’ you and your preferences, either for a single visit through a...
Roles and Capabilities
Last Updated: 19/03/2026WooCommerce registers two user roles once activated, and grants additional capabilities to the exist Admin user role: Customer role People become Customers when they register via the checkout or sign-up process. Customers: Shop Manager role Shop Manager is a role you can give someone to manage the shop without making them an Admin. They have all the rights a customer has, and...
WooCommerce REST API
Last Updated: 19/03/2026The WooCommerce REST API is a powerful tool for connecting your WooCommerce shop to external systems and resources. Unless you’re a developer, in most cases the integration you’re working with will only require you to generate API keys for you to enter in their system, and you’ll be connected to the external service! This document...
Approved Download Directories
Last Updated: 19/03/2026Approved Download Directories is a feature that helps manage which directories are allowed for the storage of downloadable product files. Introduced in WooCommerce 6.5, it’s of particular use if you already sell, or plan on selling, downloadable products, and especially if there are multiple users on your site with the ability to create and modify products....
Installed Taxonomies and Post Types
Last Updated: 19/03/2026Here we detail the taxonomies and post types specific to WooCommerce, which are fundamental for organizing and managing different content types within a WordPress site. Understanding these elements is crucial for developers and site administrators to effectively extend, customize, and manage their WooCommerce installations. Taxonomies and Post Types Two major building blocks in the WordPress...
Installed Database Tables
Last Updated: 19/03/2026WooCommerce installs some custom tables to store its data during install. More about tables installed: https://github.com/woocommerce/woocommerce/wiki/Database-Description Tables can be removed when uninstalling WooCommerce, not during deactivation. This doesn’t happen automatically. To delete the WooCommerce tables from the database entirely, follow the instructions at Uninstalling WooCommerce. Note: When defining a WordPress SQL table prefix, make sure it’s less than 20 characters. Otherwise...
WooCommerce Server Recommendations
Last Updated: 19/03/2026WooCommerce Server Recommendations are a guide to setting your site up for success and longevity. If the server running your WordPress site doesn’t meet our minimum requirements, then many plugins, including WooCommerce itself, won’t function as expected. Read over the WooCommerce Server Recommendations and additional items below. Server Requirements The first step in setting up...
WooCommerce Pages
Last Updated: 19/03/2026Installation 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 Missing Pages If you skipped...
Store settings
Last Updated: 19/03/2026Documents Configuring WooCommerce settings When you go to WooCommerce > Settings in your site’s WP Admin dashboard, you’ll notice tabs relating to the different kinds of settings available: General settings You’ll find your store’s general settings in WP Admin at WooCommerce > Settings > General. These settings include your store’s location, where you’ll sell and...
Configuring WooCommerce settings
Last Updated: 19/03/2026When you go to WooCommerce > Settings in your site’s WP Admin dashboard, you’ll notice tabs relating to the different kinds of settings available: Note:WooCommerce is highly extensible, open-source software. Extensions and plugins commonly add additional settings and tabs to the WooCommerce settings page(s). If you see additional settings to those pictured below or mentioned in the...
General settings
Last Updated: 19/03/2026From your store’s general settings page, you can enter your business address, define the regions you will sell and ship orders to, enable tax calculations and coupons, and select the currency your shop will use for sales. You can access and edit general settings via your WP Admin dashboard by navigating to WooCommerce > Settings. The General tab...
Shop currency
Last Updated: 19/03/2026Currency settings WooCommerce has several currency options to choose from when setting up your store. This document will guide you through the following: Setting a store’s base currency Each WooCommerce store can set one base currency. This currency will be displayed throughout your store and is the currency in which you will be paid. To set...
Products Settings
Last Updated: 19/03/2026The Products Settings on WooCommerce > Settings > Products control how products are displayed, measured, inventoried, and downloaded from your shop. Below you’ll find a general overview and explanation of the settings. If you need more information about adding and managing products, see our Adding and Managing Products documentation. The products settings are split between several sections which...
Advanced Settings
Last Updated: 19/03/2026The “Advanced” settings area is where you set WooCommerce pages like the cart and checkout, create access tokens to integrate external applications with the REST API, add custom webhooks to your store, and enable new or experimental features like high performance order storage and the new product editor. Find them at: WooCommerce > Settings > Advanced. The...
MaxMind geolocation integration
Last Updated: 19/03/2026The free, core WooCommerce plugin enables store owners to automatically geolocate customers to display tax rates and shipping methods specific to their location. To determine this, WooCommerce integrates with MaxMind GeoLite2 geolocation data. This document covers: Enabling geolocation To enable the MaxMind geolocation integration: Once geolocation is enabled, you’ll need to create a MaxMind account and configure...
Woo Marketplace suggestions settings
Last Updated: 19/03/2026Overview WooCommerce.com Marketplace suggestions settings in the core WooCommerce plugin give store owners the flexibility to customize their experience by managing the types of recommendations and suggestions they receive. This document provides an overview of the settings available, how they work, and best practices for customization — including a filter to disable suggestions programmatically. Introduction...
WooCommerce Coming soon mode
Last Updated: 19/03/2026Coming soon mode lets you control the visibility of your site while it is under construction. This feature is managed via the Site visibility tab in WooCommerce settings and provides flexibility and control over who can access your store during the setup phase. Enable / disable Coming soon mode As of WooCommerce 9.1, Coming soon mode is enabled by default for all stores....
How-to guides
Last Updated: 19/03/2026Helpful guides for your WooCommerce store. Documents Accessibility Tips for WooCommerce Store Owners Overview While WooCommerce provides accessible foundations, store owners play a key role in creating an inclusive experience. This page offers tips and best practices for improving the accessibility of your store’s content, design, and customizations. In many parts of the world, ecommerce...
Accessibility Tips for WooCommerce Store Owners
Last Updated: 19/03/2026Overview While WooCommerce provides accessible foundations, store owners play a key role in creating an inclusive experience. This page offers tips and best practices for improving the accessibility of your store’s content, design, and customizations. In many parts of the world, ecommerce stores are legally required to meet accessibility standards. Making your store accessible not...
How to update WooCommerce
Last Updated: 19/03/2026Updates to WooCommerce, WordPress, extensions, themes, and payment gateways are a fact of life. Our team is hard at work, releasing updates that add new features, improve security, fix issues, and, in general, make your store better than ever. But how do you update WooCommerce without causing issues? We’ll cover a few of the common ways below....
Use FTP to manage your WooCommerce site
Last Updated: 19/03/2026FTP (File Transfer Protocol) is a method to transfer files between a client and a server over the internet or a local network. In the context of managing a WordPress site, such as those running WooCommerce, FTP allows you to upload, download, or modify files directly on your web server. This can be particularly useful...
Import and export a site database
Last Updated: 19/03/2026WordPress uses a database to store all the content and settings for your WooCommerce store in a structured format. It organizes data into tables, each dedicated to different types of information such as products, customers, and orders. This organization allows for efficient data management, which can help you to easily store, retrieve, and update your...
Backing up WordPress content
Last Updated: 19/03/2026Each store powered by WooCommerce and WordPress has two places where its data and content are stored: So, how should you safeguard your content and keep it backed up? Automatic backups The most efficient and reliable approach is to use an automated backup service; we recommend Jetpack VaultPress Backup. By using Jetpack Vaultpress Backup, you’ll benefit from: Manual backups There are...
Search your WooCommerce site database
Last Updated: 19/03/2026Searching the WordPress database on your WooCommerce site can help you quickly find and manage important information, like product details, order histories, and customer data. Note: This document is meant to serve as a helpful guide for advanced troubleshooting; however, the procedures described are beyond the scope of our support policy and we cannot provide direct assistance with...
Disable plugins without admin access
Last Updated: 19/03/2026Normally, you can disable plugins — including WooCommerce — on your WordPress site from the Plugins > Installed Plugins section of your admin area. If you can’t access this part of your site’s admin area for any reason, there are other ways to disable plugins. Note: This document is meant to serve as a helpful guide for advanced...
Email authentication and sender requirements
Last Updated: 19/03/2026This document explains what email authentication is, its requirements, and how you can implement it to ensure your store’s emails are successfully delivered. In this digital age, where online transactions and communications are central to our lives, the integrity of email correspondence is more important than ever. Authenticating outbound emails from your WooCommerce store verifies to...
Hooks, actions and filters
Last Updated: 19/03/2026Hooks, actions and filters are powerful tools that allow you to modify and extend the capabilities of your WooCommerce site without altering the core code. This document will give you a brief overview of these and an example of how to apply them to your WooCommerce site. Note: This document is meant to serve as a...
Troubleshoot payment errors
Last Updated: 19/03/2026Troubleshooting 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 encountering errors, these...
How to update your PHP version
Last Updated: 19/03/2026PHP is the most popular server-side scripting language, powering millions of websites including most WooCommerce stores. If you arrived at this page from the notice in your WooCommerce store, your store is running an outdated and unmaintained version of PHP. Not only is your website’s performance (a lot) lower than it should be, you may find that...
HTTP and response codes
Last Updated: 19/03/2026When 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...
The .htaccess file
Last Updated: 19/03/2026The .htaccess file is a configuration file used on web servers running the Apache software. It’s important because it helps manage how your website behaves. For instance, you can use it to set up URL redirects, control access to your site’s files, and enhance security measures. Here’s why the .htaccess file is crucial for your WooCommerce site:...
Understanding the WordPress wp-config.php file
Last Updated: 19/03/2026The wp-config.php file is a core configuration file for WordPress. It contains essential settings that allow your website to connect to its database and function properly. This file is created when you first set up WordPress, and it stores information such as: You’ll find the wp-config.php file in the root directory of your WordPress installation. If you’re using a...
WordPress functions
Last Updated: 19/03/2026In WooCommerce and WordPress, functions are blocks of code that perform specific tasks on your website, like displaying posts or adding products to a cart. They streamline complex processes, making your website run more efficiently and consistently. By using functions, you can avoid repeating code, keeping your site’s backend clean and manageable. Think of functions as...
Connect your store to a WordPress.com account
Last Updated: 19/03/2026A WordPress.com account acts like a passport for your WooCommerce store, connecting it to powerful services from WordPress.com and Automattic. These include: Creating an account If you don’t already have a WordPress.com account, use the connection screen to create a new account. Enter your email address and click the Continue with email button, or continue with one...
WordPress nonces
Last Updated: 19/03/2026The term “nonce” stands for “number used once.” It is a security measure used to ensure that a specific request or submission cannot be reused maliciously. This one-time number helps protect websites from various types of attacks, such as forgery, by making sure each transaction or session is unique and temporarily valid. Note: This document is...
Installing and Uninstalling WooCommerce
Last Updated: 19/03/2026Overview WooCommerce can be installed and uninstalled the same as any other WordPress plugin. The Setup wizard provides an optional step for installing and fully configuring WooCommerce. Take a moment to review the server requirements before installation, or you may encounter issues when using WooCommerce. If you need a new host or don’t have one yet, see...
Guidelines – Refund and Return Policy Page
Last Updated: 19/03/2026This page provides helpful guidelines for creating an effective Refund and Return Policy for your WooCommerce store. It covers essential topics such as the importance of having a clear policy, noting items that can or cannot be refunded, deciding who pays return shipping charges, and setting customer expectations for refund timelines. Additionally, it mentions legal...
Importing WooCommerce Sample Data
Last Updated: 19/03/2026Right after installing WooCommerce, your store may look empty — no products, orders, reviews. This is intentional so you can get started creating your own products and setting up WooCommerce exactly as you need. But maybe you’d like to see what a store full of sample products looks like. If so, we’ve got some data...
How To CHMOD the cache folder
Last Updated: 19/03/2026In order for the image resizer to be able to show resized images, it needs to have permission to store the resized files in a cache folder. This folder is located in your theme folder for example: wp-content/themes/freshnews/cache/. To allow the image resizer to write to this folder, you have to CHMOD the cache folder. What is...
SSL, HTTPS, and WooCommerce
Last Updated: 19/03/2026This 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...
Update PHP and WordPress
Last Updated: 19/03/2026To optimize your WooCommerce store’s performance and security, it should be running the minimum supported versions of PHP and WordPress. This keeps your business running smoothly and creates the best online experience for customers. WooCommerce Minimum Requirements PHP versions less than 8.1 and MySQL versions less than 5.6 no longer receive active support, many versions...
Automation
Last Updated: 19/03/2026Documents Scheduled actions Scheduled actions manage background tasks related to WooCommerce order notifications and payment processing. Gaining a clear understanding of these actions can help your store run more efficiently, and prevent issues — such as missed order updates or delayed customer emails. You can find all scheduled actions in your store’s WP Admin dashboard under...
Scheduled actions
Last Updated: 19/03/2026Scheduled actions manage background tasks related to WooCommerce order notifications and payment processing. Gaining a clear understanding of these actions can help your store run more efficiently, and prevent issues — such as missed order updates or delayed customer emails. You can find all scheduled actions in your store’s WP Admin dashboard under WooCommerce > Status >...
Webhooks
Last Updated: 19/03/2026In this guide we explain in more details what webhooks are and how they are used. What are Webhooks? A Webhook is an event notification sent to a URL of your choice. Merchants (or their developers) can configure a webhook that are triggered by events on one site, to invoke behavior on another site. Webhooks are useful...
Performance
Last Updated: 19/03/2026Documents High-Performance Order Storage High-Performance Order Storage (HPOS) (previously known as Custom Order Tables) is a solution specifically designed for ecommerce needs that provides a simple-to-understand, solid database structure. It uses Woo’s Create, Read, Update, Delete (CRUD) design to store order data in custom tables optimized for WooCommerce queries, with minimal impact on the store’s performance. What’s...
High-Performance Order Storage
Last Updated: 19/03/2026High-Performance Order Storage (HPOS) (previously known as Custom Order Tables) is a solution specifically designed for ecommerce needs that provides a simple-to-understand, solid database structure. It uses Woo’s Create, Read, Update, Delete (CRUD) design to store order data in custom tables optimized for WooCommerce queries, with minimal impact on the store’s performance. What’s new with High-Performance Order...
Troubleshooting a slow site
Last Updated: 19/03/2026The first step for troubleshooting a slow WooCommerce site is to determine the root cause. Cache and CDN Using a caching plugin such as WP Super Cache is a good way to optimize site performance. You can also use a Content Delivery Network (CDN) such as Jetpack’s site accelerator or Cloudflare to speed your site up further. Be careful, though — caching plugins have...
WP_options table and site speed
Last Updated: 19/03/2026When a WordPress site runs slowly, the wp_options table is often overlooked. This table stores key site data, like permalinks, site settings, scheduled posts, and widget details. If you have already tried the most common steps for troubleshooting a slow WooCommerce site, reviewing the wp_options table would be a good next step. Almost every page — whether on the front...
Problems with large amounts of data not saving (variations, rates etc)
Last Updated: 19/03/2026If 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 to increase its...
Endless loading/spinner on the checkout page
Last Updated: 19/03/2026The ‘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 error due...
jQuery.cookie.js/jQuery.cookie.min.js scripts fail to load
Last Updated: 19/03/2026This 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...
Localization
Last Updated: 19/03/2026Documents Translating WooCommerce Extensions Plugins sold on WooCommerce.com are translation ready and can be used with any translation plugin. Some even have bundled translations available and we’re always happy to work with translators to increase translation coverage! If you’re interested in translating WooCommerce or extensions, please review this document on localization to get started. Using...
Translating WooCommerce Extensions
Last Updated: 19/03/2026Plugins sold on WooCommerce.com are translation ready and can be used with any translation plugin. Some even have bundled translations available and we’re always happy to work with translators to increase translation coverage! If you’re interested in translating WooCommerce or extensions, please review this document on localization to get started. Using a Bundled Translation If a plugin...
Extension translations
Last Updated: 19/03/2026We are beginning to translate WooCommerce-owned extensions into multiple languages, starting with Spanish. Supported languages are highlighted on each product page, with country flags helping to identify whether the extension is supported in that location. We will not force vendors to provide translations of their extensions. If a vendor would like to provide translations of...
Translating WooCommerce
Last Updated: 19/03/2026WooCommerce is already translated into a few languages and is translation-ready out of the box. All that is needed is a translation file for your language, which is automatically installed for the languages on this list by changing the site’s language. On this page you’ll learn: Set up WordPress in your language The first step to translating WooCommerce...
Security
Last Updated: 19/03/2026Documents Advisory: Increased Suspicious Card Activity Reported by PayPal PayPal has recently informed us of increased suspicious card activity affecting merchants across the market. This notice is to help WooCommerce stores understand the situation, take the appropriate security steps, and ensure that checkout flows remain protected. This advisory applies specifically to stores using the PayPal...
Advisory: Increased Suspicious Card Activity Reported by PayPal
Last Updated: 19/03/2026PayPal has recently informed us of increased suspicious card activity affecting merchants across the market. This notice is to help WooCommerce stores understand the situation, take the appropriate security steps, and ensure that checkout flows remain protected. This advisory applies specifically to stores using the PayPal Payments plugin and PayPal’s built-in fraud-prevention features. WooCommerce stores using PayPal...
Advisory: Phishing campaign targeting WooCommerce stores
Last Updated: 19/03/2026This advisory originally appeared on the WooCommerce Developer blog. In the past we have identified phishing campaigns targeting WooCommerce store owners. These emails have falsely claimed to be from WooCommerce and alert users about critical security vulnerabilities that do not exist. If you receive any emails such as these, always confirm that emails are arriving from...
Store design
Last Updated: 19/03/2026Categories Classic themes Shortcodes included with WooCommerce WooCommerce Customizer — Manage Store Notice, Catalog View, and Product Images Product Page and Product Images See all topics Block themes Store Editing is a new paradigm for managing your store's design. Use this content to learn how the editor (and this system) works. Getting to Know the...
WooCommerce store editing
Last Updated: 19/03/2026Welcome to our guide to customizing your WooCommerce store using blocks, block themes, and full-site editing. You’ll learn how to: Whether you’re looking to fine-tune your store’s templates, create a new design with blocks, or create custom product pages for specific products, we’ve got you covered. We aim to help you harness the full potential...
Widgets included with WooCommerce
Last Updated: 19/03/2026Several widgets come with WooCommerce that help you display products in a multitude of ways in your themes widgetized areas. Although, in modern themes, adding WooCommerce Blocks to widget areas is a more versatile and flexible approach. Included Widgets The default included widgets below, now referred to as Legacy Widgets, are still available to add to...
Classic themes
Last Updated: 19/03/2026Documents Shortcodes included with WooCommerce WooCommerce has traditionally utilized shortcodes to add dynamic content and features to WordPress pages. With WordPress’s evolution toward the Gutenberg block-based editor, the focus has shifted from shortcodes to more interactive and visually integrated blocks. While the block editor offers interactively customizable blocks and enhanced editing capabilities, we recognize many...
Shortcodes included with WooCommerce
Last Updated: 19/03/2026Note:WooCommerce blocks are the simplest, most flexible way to display products on posts and pages. Learn more about WooCommerce blocks. WooCommerce has traditionally utilized shortcodes to add dynamic content and features to WordPress pages. With WordPress’s evolution toward the Gutenberg block-based editor, the focus has shifted from shortcodes to more interactive and visually integrated blocks. While...
WooCommerce Customizer — Manage Store Notice, Catalog View, and Product Images
Last Updated: 19/03/2026WooCommerce Customizer is part of WordPress > Customize and makes it possible to select options that apply site-wide for Store Notice, Product Catalog, and Product Images without touching any code. Note:Block themes supporting full site editing and don’t use the customizer. However, when you access the URL directly: https://example.com/wp-admin/customize.php the customizer and the WooCommerce customizer settings can be accessed....
Product Page and Product Images
Last Updated: 19/03/2026The WooCommerce Customizer includes a couple different display settings for the Product Page and Product images. On this page you’ll learn how to: Product Page The WooCommerce Customizer lets you choose how to display product pages. Navigate to Appearance > Customize > WooCommerce > Product Page, and you’ll find two display options for the product page: Sticky...
Store Notice
Last Updated: 19/03/2026Note: The customizer is hidden If you are using a block theme that supports Full Site Editing. However, when you access the URL directly: https://example.com/wp-admin/customize.php the customizer and the WooCommerce customizer settings will load. Additionally, the customizer may still be available on a block theme if another plugin is installed that registers/uses settings on the the customizer page....
Checkout
Last Updated: 19/03/2026The WooCommerce Customizer has a few settings to change the appearance of the default WooCommerce checkout. If you are using the checkout shortcode you can set whether certain fields on the checkout form are required or optional. If you are using the Checkout Block (default for all new WooCommerce installs), you’ll see a link directing you to the site...
Related Products, Add-to-Cart, and Notification Shortcodes
Last Updated: 19/03/2026On this page are shortcodes for adding a related product section, an add-to-cart button with price, and showing shop messages/notifications on non-WooCommerce pages. Listed below are each shortcode and their attributes. Related Products If you want to show the related products (products with similar tags or categories) on a single product page to encourage cross-sells/up-sells you can use the [related_products] shortcode. Below...
Troubleshooting shortcodes
Last Updated: 19/03/2026On 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 marks A common problem...
Product Category Shortcodes
Last Updated: 19/03/2026These two shortcodes will display your product categories on any page. Available Product Category attributes Examples of Product Category Scenarios Show Top Level Categories Only Imagine you only wanted to show top level categories on a page and exclude the sub categories, well it’s possible with the following shortcode. Questions and support Do you still...
Product shortcodes
Last Updated: 19/03/2026While WooCommerce primarily uses blocks to offer interactive and customizable display settings for products, you can still use legacy product shortcodes on your store by adding them to a shortcode block. This document lists and explains the available WooCommerce product-related shortcodes. Note:The core WooCommerce plugin includes several product blocks which can be more powerful and flexible compared to shortcodes, learn...
Product Catalog
Last Updated: 19/03/2026The WooCommerce Customizer allows you to set the general configuration of your product catalog. This page explains: To edit the product catalog settings, navigate to Appearance > Customize > WooCommerce > Product Catalog. The next few sections of this page will explain each of these settings in more detail. Shop Page Your Shop Page can display Products, Categories, or...
Block themes
Last Updated: 19/03/2026Store Editing is a new paradigm for managing your store's design. Use this content to learn how the editor (and this system) works. Categories Customizing your store Check these guides for explanations on how to customize the different sections of your WooCommerce store. Note that many of these details only apply when your site is...
Getting to Know the Site Editor
Last Updated: 19/03/2026The Site Editor is where you’ll make customizations to your site using templates and blocks. This page provides an overview of the WordPress Site Editor, the central tool for editing your store’s templates and page content. You will learn how to access the editor, navigate blocks and content via the list view, and redo or...
Templates
Last Updated: 19/03/2026Templates are arrangements of blocks that determine the appearance and layout of multiple posts, pages, and products. You can create custom templates or use the templates provided by your theme or a plugin. When you make changes to a template, the editor updates the blocks on all pages/posts that use the template. Learn more about the Template Editor. WooCommerce templates...
Patterns and Template Parts
Last Updated: 19/03/2026In WordPress and the block editor, patterns and template parts are useful tools for customizing your online store’s layout and design while avoiding the need to build the same designs over and over. Patterns are pre-designed sections that you can easily insert into your pages and posts. Patterns can be either synced or independent(unsynced), allowing...
Using Blocks in WooCommerce
Last Updated: 19/03/2026WooCommerce includes a number of blocks that you can insert in posts, pages and Site Editor patterns and templates to customize your catalog, promote your products, and deliver a great checkout experience to your shoppers. In this guide, we cover the basics of how blocks work, where to find their settings, and how to revert...
Mini Cart for WooCommerce
Last Updated: 19/03/2026Add a WooCommerce Mini Cart to your shop pages or WooCommerce cart anywhere with the help of a shortcode to provide quick and easy access to cart details for customers. Installation To start using a product from WooCommerce.com, you can use the “Add to store” functionality on the order confirmation page or the My subscriptions section in...
Accordion Group Block
Last Updated: 19/03/2026The Accordion Group block provides a clean and interactive way to display collapsible content on your store and product pages. It is designed to help merchants organize information into manageable, expandable sections, enhancing both readability and user experience. By grouping multiple accordion items, this block allows you to present information in a compact, user-friendly format, reducing page...
Product Collection Block
Last Updated: 19/03/2026The Product Collection block is designed to help you display and customize archives of products; and offer product recommendations. Upon inserting the block, and depending on the template or page that you are currently editing, you will be prompted to create your own custom product collection; or choose from a list of variations/recipes that enable...
Add to Cart + Options Block
Last Updated: 19/03/2026The Add to Cart with Options block displays an Add to Cart button along with quantity selectors and, depending on the product type, additional selection inputs. This block allows customers to add a product directly to their cart with their chosen configuration. Introduced in WooCommerce 10.0, the new Add to Cart + Options (Beta) block...
Product Gallery Block
Last Updated: 19/03/2026The Product Gallery block is a flexible and interactive way to showcase product images and media within your store. This block allows customers to view detailed visual representations of your products through a combination of thumbnail images and a larger display image in gallery view. Block structure It is composed of two main inner blocks: Block settings...
Single Product Block
Last Updated: 19/03/2026The Single Product block in WooCommerce lets you showcase an individual product anywhere on your site, whether it’s a landing page, blog post, or homepage. This block brings the full product experience into the WordPress Block Editor, allowing you to display key product details, such as product image, price, description, reviews, and an Add to...
Cart block
Last Updated: 19/03/2026The Cart block in WooCommerce allows customers to review and manage the items they intend to purchase. It offers options for updating quantities and removing products, as well as reviewing shipping options and adding coupons to the order. This page explains the components of the Cart block and how to customize both its filled and...
Checkout block
Last Updated: 19/03/2026The Checkout block is part of a simplified, conversion-optimized checkout flow. It’s where a customer completes their purchase by entering shopping and payment information. This page provides an overview of the structure of the Checkout block, its settings, and customization options to control your store’s brand identity — and create a visually appealing checkout journey for...
Customizing your store
Last Updated: 19/03/2026Check these guides for explanations on how to customize the different sections of your WooCommerce store. Note that many of these details only apply when your site is using a block theme. Documents Customizing your product catalog With store editing, you can build shop pages exactly the way you want by editing your Product Catalog...
Customizing your product catalog
Last Updated: 19/03/2026With store editing, you can build shop pages exactly the way you want by editing your Product Catalog templates and customizing the layout and styles using blocks within the site editor. In this document, we cover the templates and blocks included in WooCommerce for managing and customizing your catalog pages. Beyond the main shop page, WooCommerce displays your...
Customizing Your Product Pages
Last Updated: 19/03/2026Product pages are the most detailed view your customers will get of your product before deciding whether to buy it. Depending on what you’re selling you may want to give as much information as possible to help your buyers make the right decision, or keep things straightforward for a tight conversion funnel. With WooCommerce Store...
Customizing the Cart and Checkout Pages
Last Updated: 19/03/2026The Cart and Checkout pages are a critical part of the shopping experience. The WooCommerce Cart and Checkout blocks provide customers with a seamless process for reviewing and finalizing their purchases in a low-friction way that maximizes conversion. Here we cover the templates and blocks associated with these pages along with details around upgrading to...
Customizing the Order Confirmation Page
Last Updated: 19/03/2026The “Thank you” page your shoppers see after placing their order, otherwise known as the “Order Confirmation page” provides customers with peace of mind by confirming their order details after a purchase. Here we explain the template that WooCommerce uses on block themes to display this page, and outline the structure of the blocks that...
Coming soon page template
Last Updated: 19/03/2026The Coming Soon page template in WooCommerce is fully customizable through the Site Editor, allowing you to modify its design to align with your brand. You can adjust colors, fonts, and layout, ensuring that your coming soon page reflects your store’s identity while maintaining an engaging appearance. New Coming Soon Designs in WooCommerce 9.8+ WooCommerce 9.8 introduced...
Product Filters block
Last Updated: 19/03/2026Effective product filtering improves the shopping experience by allowing customers to easily find the products they need and proceed to checkout without unnecessary delays. WooCommerce now offers the Product Filters block to streamline this process, enabling shoppers to filter products in your store’s catalog. The Product Filters block provides a fast, seamless experience, where filters are dynamically...
Mini-Cart block
Last Updated: 19/03/2026The Mini-Cart block is added to the site header of many block themes by default. It gives customers a way to quickly view and edit their cart contents from any page on your store. This guide explains the functionality of the Mini-Cart block and provides instructions for customizing its appearance and behavior to ensure a...
WooCommerce Blocks: Local Pickup
Last Updated: 19/03/2026Local Pickup in Blocks is a new enhanced delivery method that allows you to easily offer one or more pickup locations to your customers. We’ve made it easier for you to setup local pickup options by providing a new, simple to use Local Pickup settings page. This new method provides a streamlined customer experience by:...
Mobile App
Last Updated: 19/03/2026Categories Android Menu My Store Orders See all topics iOS Menu My Store Orders See all topics Documents Additional users Adding users to your online store can improve the efficiency and scalability of your business. Users with defined roles can facilitate smoother day-to-day management, whether you’re growing your team, delegating responsibilities, or maintaining continuous operations....
Additional users
Last Updated: 19/03/2026Adding users to your online store can improve the efficiency and scalability of your business. Users with defined roles can facilitate smoother day-to-day management, whether you’re growing your team, delegating responsibilities, or maintaining continuous operations. With more users, merchants can delegate tasks such as inventory updates, customer service, and order processing. This collaborative approach can...
App language settings
Last Updated: 19/03/2026The Woo Mobile App for Android and iOS will use the language set in your device settings. For example, if your phone or tablet is set to English, the Woo Mobile App will also be in English. If you change the system language to French, the app will update to reflect this change. The following...
Barcode and QR code scanner
Last Updated: 19/03/2026Looking to use a physical scanner in Point of Sale (POS) mode? Check out our documentation here. The WooCommerce Mobile App supports the most widely used barcode formats on both Android and iOS platforms. This powerful tool streamlines your workflow by allowing you to create new orders directly from the Orders screen. Add products to orders during the order creation...
Cash payments
Last Updated: 19/03/2026Merchants using the WooCommerce Mobile App can accept payments in person via card reader, Tap to Pay, or cash. How to enable cash payments To enable cash payments through the mobile app: Still experiencing issues? If you’re using the Jetpack plugin to connect the mobile app to your site, ensure that the Jetpack connection is active and...
Creating or editing orders on the mobile app
Last Updated: 19/03/2026The latest versions of the mobile apps (versions 8.9.0 and above) give you the ability to create orders. Note: To obtain the best experience, we recommend you update your store to the latest version of WooCommerce. The mobile apps currently support: Creating a new order Follow these steps to create an order: Adding Products & Product Variations Adding Products...
Creating, viewing, and editing coupons
Last Updated: 19/03/2026Managing coupons in the WooCommerce Mobile App is similar to your desktop site. To learn more about coupon management, please see Managing coupons in WooCommerce. To view, edit, or create a coupon in the mobile app, tap Menu > Coupons. Viewing coupons Creating a coupon From the Coupons menu, click the add/plus (+) icon in the bottom-right corner to create a new coupon....
How do I log out from all my devices?
Last Updated: 19/03/2026From time to time, you may need to log out of all devices connected to your WooCommerce store — including the WooCommerce Mobile App. For stores connected to Jetpack: You must log out of the Woo Mobile App and log back in to reconnect your device. For stores connected via application passwords: Still experiencing issues? If you’re using the Jetpack...
How timezones work in the Woo Mobile app
Last Updated: 19/03/2026The Woo Mobile App uses the timezone set in your site’s WP Admin dashboard under Settings > General > Timezone. If this information is not available, the mobile app will default to the timezone of the device being used; this applies to all statistics and order-related information. Example For example, let’s say your store is set to the New York City timezone,...
How to Create a Blaze Campaign
Last Updated: 19/03/2026Requirements The Jetpack plugin should be installed and connected to your site. New to Jetpack? Check out this support guide to get started with that. Starting with Jetpack 12.3, Blaze needs to be activated under the Jetpack Feature modules page. Or you need to install the Blaze for WooCommerce extension. Blaze your content Follow these steps to set up a Blaze campaign: 2....
How to Hide Sites from the Store Picker
Last Updated: 19/03/2026In the Woo Mobile app, when you log in using your WordPress.com account (Jetpack Sites) you can access all stores connected to that specific account. This can be very handy for users managing multiple stores since you can easily switch between stores from the app without having to log out and log into a different store. That...
How to Login into the App
Last Updated: 19/03/2026After downloading and installing the app from your preferred app store and opening the app, click on the Log In button: Enter Your Site Address Where can I find my site address? If you can visit your site on a browser, you already have the site address. You can get it from the address bar (the place...
Jetpack setup instructions for the WooCommerce Mobile App
Last Updated: 19/03/2026Once you’ve installed the WooCommerce Mobile App, you can access additional features — such as stats and push notifications for new orders — by connecting your store to Jetpack. 1. Install the Jetpack plugin 2. Activate Jetpack 2. Click the Activate Jetpack in one click button. 3. Once Jetpack is activated, you can choose a paid plan or scroll to the bottom of...
Plugin conflicts with the WooCommerce Mobile App
Last Updated: 19/03/2026You may occasionally experience conflicts with extensions and plugins that can prevent the WooCommerce Mobile App from fetching and displaying data correctly. These conflicts can occur due to the various ways third-party plugins and extensions interact with the core WooCommerce plugin. To ensure a smooth experience, it’s important to be aware of potential conflicts and...
Point of Sale Mode: Barcode Scanning
Last Updated: 19/03/2026The WooCommerce Mobile app supports barcode scanning when using the Point of Sale (POS) mode. Barcode scanning allows you to connect a supported external barcode scanner to scan products supported barcodes and automatically add the product to the Cart when in POS mode. Setting Up Barcode Scanning To start scanning barcodes, we will need to ensure that...
Receipts
Last Updated: 19/03/2026When you are using the app for in-person sales an email receipt is sent automatically upon payment collection if a customer email address is set on the order. You can also send the email receipt manually after the payment. Note: As an In-Person Payments merchant, you are obligated to provide your customers the option of a printed receipt for...
Share Payment Link
Last Updated: 19/03/2026Share Payment Link is a new feature added to WooCommerce Mobile (from WCiOS 8.3 and WCAndroid 9.6) to help collect payments from your customers. With this new functionality, you can share a payment link with your customers through social networks, emails, or messages. Creating a Payment Link You can create a Payment Link for any orders awaiting payment. To create...
Support guide
Last Updated: 19/03/2026Before reaching out to support, you might want to review our helpful WooCommerce Mobile App documentation to see if your question is already answered. Our support documentation contains an extensive collection of up-to-date guides covering all aspects of our mobile app. We have screenshots and step-by-step walkthroughs to help you learn how to use the app and resolve...
Supported Extensions
Last Updated: 19/03/2026The following extensions are supported by or add features to the WooCommerce Mobile App: Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack connection is active and working correctly. You can verify some known issues or try reconnecting your site. If you’re still having difficulty, please fill...
Tap to Pay on Android
Last Updated: 19/03/2026With Tap to Pay and the Woo Mobile App, merchants based in the United States, the United Kingdom, and Canada can accept in-person contactless payments, right on their Android phone — no extra terminals, hardware, or readers needed. Requirements Tap to Pay on Android is supported for U.S., UK, and Canadian merchants whose Android device meets all of the following...
Troubleshoot receipt issues
Last Updated: 19/03/2026This page is a handy guide for helping to troubleshoot some of the more common issues you may encounter when trying to generate a receipt for customers through the Woo Mobile app. Receipt failed to generate If a receipt fails to generate, check if your device is offline, as this might prevent access to the...
Troubleshooting errors loading data
Last Updated: 19/03/2026If you are having trouble loading data in the WooCommerce Mobile App — such as your store stats, orders, products, or reviews — here are some potential issues that could be causing this problem and how to solve them: Updating the WooCommerce database If data in the app isn’t loading as expected, you’ll first want to...
Troubleshooting image upload issues in the Woo Mobile App
Last Updated: 19/03/2026Here are some error messages you may encounter in the Woo Mobile App when attempting to upload product images or downloadable files. The corresponding HMAC for this file does not match This usually means that the file(s) you want to upload exceeds the limit imposed by the server. The simplest test to check for this...
What is a WordPress.com account?
Last Updated: 19/03/2026A WordPress.com account is the passport that allows you to access WooCommerce.com and other services owned by Automattic such as Jetpack, Gravatar, and Akismet. We use a WordPress.com account to manage logins for WooCommerce.com. To shop and manage purchases on WooCommerce.com, you’ll need to use your WordPress.com account. Do I need a WordPress.com account to...
Woo Mobile App logs
Last Updated: 19/03/2026The Woo Mobile App logs record various errors and events and can help you troubleshoot common issues. Here’s a breakdown of what the messages mean and what actions you can take. iOS “[StripeTerminal] …” These errors come from the Stripe Terminal SDK. They can help diagnose problems with connecting to card readers or processing payments....
Woo Mobile App notifications
Last Updated: 19/03/2026With push notifications in the Woo Mobile App, you can manage your online store more efficiently and make timely decisions that keep your business running smoothly and your customers happy. These notifications are sent directly to your mobile device, enabling you to promptly process and fulfill orders, respond to customer feedback, reduce delays, and prevent...
Woo Mobile App: Currency Display Settings
Last Updated: 19/03/2026The currency display settings shown throughout the Woo Mobile App — including currency symbol, currency position, thousand separator, decimal separator, and number of decimals — are fetched directly from your WooCommerce store settings. These settings are read-only in the mobile app and cannot be updated from within the app interface. Currency display settings To change how currency...
Woo Mobile App: Point of Sale Mode
Last Updated: 19/03/2026The WooCommerce mobile app is proud to support an early version of our new feature: Point of Sale (POS) mode. POS mode allows you to use a supported tablet like a digital cash register. When using this mode, merchants can add products to the cart with a single tap, and then take in-person payment from...
Getting started with In-Person Payments with Stripe
Last Updated: 19/03/2026With the Stripe WooCommerce Extension, your customers can pay for products and services in-person using the M2 (in the US) and WisePad3 card reader (in the UK). Alternatively, you can get started with no additional hardware using Tap to Pay on iPhone, or Tap to Pay on Android. In-Person Payments via Stripe is available to qualified merchants using iPhone,...
Creating Shipping Labels in the Mobile Apps
Last Updated: 19/03/2026The WooCommerce mobile apps support purchasing and printing shipping labels for stores with WooCommerce Shipping & Tax or WooCommerce Shipping extension installed. This guide provides step-by-step instructions to purchase and print shipping labels directly from mobile devices. For help with installing the WooCommerce Shipping & Tax extension for your store, please visit the installation guide. Purchase Shipping Labels 1. To...
Getting started with In-Person Payments with WooPayments
Last Updated: 19/03/2026With WooCommerce In-Person Payments, your customers can pay for products and services in-person using the M2 card reader, WisePad 3 card reader, or Tap to Pay on a compatible iPhone or Android device. Currently, In-Person Payments & Tap to Pay for WooPayments are available for the following countries and features: Country / Features Card Reader model for In-Person Payments Tap to Pay on iPhone Tap...
WooCommerce In-Person Payments: M2 Card Reader Quick Start Guide
Last Updated: 19/03/2026The M2 Card Reader is supported for merchants in the United States. Package contents Application download and installation This device supports iOS and Android. Connecting the reader Charge the reader Charge the reader using the included charger for approximately two (2) hours. Charging before the first use helps to prevent potential damage to it. The reader’s...
Tap to Pay on iPhone
Last Updated: 19/03/2026With Tap to Pay and the Woo Mobile App, merchants based in the United States and the United Kingdom can accept in-person contactless payments, right on their iPhone — no extra terminals, hardware, or readers needed. Requirements Tap to Pay on iPhone is supported for U.S. and UK merchants whose iPhone meets all of the following requirements: NOTE: UK merchants require...
WooCommerce In-Person Payments: WisePad 3 Quick Start Guide
Last Updated: 19/03/2026The WisePad 3 is supported for merchants in the UK and Canada. Package Contents Application Download & Installation This device supports iOS & Android. Connecting the WisePad 3 card reader Charge the card reader Charge the card reader using the supplied charging cable for approximately 2-3 hours. Charging before the first use helps to prevent...
WooPayments: In-Person Payments
Last Updated: 19/03/2026Spanish version of this page | Aquí puedes encontrar la versión en español de esta página With WooPayments’ In-Person Payments feature, your customers can pay via tap, swipe, chip card, or mobile wallet payments, all using our mobile app and a simple card reader or a device that supports Tap to Pay on iPhone or Android. In-Person...
In-Person Payments Card Reader Return Policy
Last Updated: 19/03/2026The card readers follow the same refund policy as any other product in our WooCommerce Marketplace. For more information on our refund policy, please visit this page: Refund Policy
Android
Last Updated: 19/03/2026Documents Menu Menu The Menu tab is home to admin tasks including switching stores, accessing your store’s WooCommerce Admin, your store view, reviews, and app settings. To access this view tap the Menu icon on the navigation bar at the bottom-right. Still experiencing issues? If you’re using the Jetpack plugin to connect the app to...
Menu
Last Updated: 19/03/2026Menu The Menu tab is home to admin tasks including switching stores, accessing your store’s WooCommerce Admin, your store view, reviews, and app settings. To access this view tap the Menu icon on the navigation bar at the bottom-right. Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack...
My Store
Last Updated: 19/03/2026The My Store tab provides sales and visitor data and gives insight into sales trends. It’s the default view when launching the app, but can be accessed from any other view by tapping the My Store icon next to the navigation bar at the bottom-left of the screen. Store Stats The top section of My Store displays Visitors (if your site is connected to...
Orders
Last Updated: 19/03/2026Orders The Orders tab allows access to a list of orders, gives you the option to filter it by status, search for a specific order, and view and manage orders. To access this view, tap the Orders icon on the navigation bar, bottom-left. Order Filter Orders can be filtered by Order Status and/or Date Range. Order Search To search for a specific order or...
Setting up the WooCommerce Android app on a simulator
Last Updated: 19/03/2026From time to time, you may find it beneficial for testing or troubleshooting the WooCommerce Android app, to view it from an Android simulator. This guide will walk you through how to set that up. Note: This document is meant to serve as a helpful guide for advanced troubleshooting; however, the procedures described are beyond the...
Settings
Last Updated: 19/03/2026Settings can be found by navigating to Menu and tapping the Settings tab. From here you’ll find the following settings and their respective functions: Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack connection is active and working correctly. You can verify some known issues or try reconnecting your site....
Widgets
Last Updated: 19/03/2026You can add the Today widget to your device’s home screen for quick access to your current day’s stats without opening the app. If you go to your device home screen and press and hold on an empty space, you will find Widgets. Then you can scroll through the list to find the Today widget. Note: The exact steps to add a...
WooCommerce for Android
Last Updated: 19/03/2026The official WooCommerce for Android App is now available for free from the Google Play Store via WooCommerce.app. This guide walks you through setup, including how to connect to your store and use the app. Requirements Note: Older versions of Android may be used but will not support the latest version of the mobile app or receive updates. Installation Your...
iOS
Last Updated: 19/03/2026Documents Menu The Menu tab is home to admin tasks, including switching stores, setting up payments on the go, accessing your store’s WooCommerce Admin, your store view, reviews, and app settings. To access this view tap the Menu icon on the navigation bar at the bottom-right. Still experiencing issues? If you’re using the Jetpack plugin...
Menu
Last Updated: 19/03/2026The Menu tab is home to admin tasks, including switching stores, setting up payments on the go, accessing your store’s WooCommerce Admin, your store view, reviews, and app settings. To access this view tap the Menu icon on the navigation bar at the bottom-right. Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your...
My Store
Last Updated: 19/03/2026The My Store tab provides sales and visitor data and gives insight into sales trends. It’s the default view when launching the app, but can be accessed from any other view by tapping the My Store icon next to the navigation bar at the bottom-left of the screen. Store Stats The top section of My Store displays Visitors (if your site is connected to...
Orders
Last Updated: 19/03/2026To access the Orders tab in the WooCommerce Mobile App, tap the Orders icon on the bottom-left of the navigation bar. The Orders tab allows access to a list of orders, which you can filter by status or search for a specific order. Click on an order to view or manage it. To create an order, please read over the documentation on...
Products
Last Updated: 19/03/2026The Products tab allows you to access a list of products that can be sorted or filtered by stock status, product type, or category, search for a specific product, view and manage, and add new ones. To access this view, tap the Products icon on the navigation bar at the bottom-right. Product Sort and Filter Products can be sorted ascending or...
Settings
Last Updated: 19/03/2026Settings can be found by navigating to Menu and tapping the Settings button at the top of the screen. From here, you’ll find the following settings and their respective functions: Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack connection is active and working correctly. You can verify...
Widgets
Last Updated: 19/03/2026You can add the Today widget to your iPhone’s home screen for quick access to your current day’s stats without opening the app. Still experiencing issues? If you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack connection is active and working correctly. You can verify some known issues or try reconnecting your site. If...
WooCommerce for iOS
Last Updated: 19/03/2026The official WooCommerce iOS App is available for free from the Apple iTunes Store via WooCommerce.app. This guide walks you through setup, how to connect your store, and how to use the app. Requirements Note: Older versions of iOS may be used, but will not support the latest version of the apps or receive updates. The official WooCommerce iOS App also...
Get help
Last Updated: 19/03/2026Get help with WooCommerce and WordPress by checking out our collection of guides, FAQs, and documentation. Start here: our troubleshooting guide addresses some of the most common issues. You can also get help from your fellow merchants in the WooCommerce support forums. Categories Troubleshooting Not sure where to start? Check out our Troubleshooting Guide to read about common issues...
Get tailored help fast with Woo’s AI Assistant
Last Updated: 19/03/2026Right 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...
Get help in your WooCommerce store admin dashboard
Last Updated: 19/03/2026You can access help from most WooCommerce pages in your store’s WP Admin dashboard via the Help tab. How to find the Help tab Help options A detailed help screen will appear with three tabs on the left side: More information The right-hand sidebar contains more options: Questions and support Do you still have questions and need assistance? This...
How to get help
Last Updated: 19/03/2026To get support for issues and questions you might have, there are two paths: Chat with our AI assistant On each page of our documentation, as well as on the Get Support page of your account area, we have a WooCommerce specialist AI Assistant with access to all the documentation on WooCommerce.com, which is purpose-built to help...
Advisory: US de minimis is ending — what to know (and do)
Last Updated: 19/03/2026Effective date: August 29, 2025 (12:01 am ET) The United States has suspended duty-free de minimis treatment under 19 U.S.C. 1321(a)(2)(C) for low-value imports from all countries. Most shipments that previously entered duty-free at ≤ $800 USD are now dutiable and must meet full admissibility requirements. For more background and an overview of the steps ecommerce businesses can take to adapt to...
Troubleshooting
Last Updated: 19/03/2026Not 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...
WooCommerce self-service guide
Last Updated: 19/03/2026Please review this guide to see if these solutions apply before submitting a ticket. 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...
Troubleshooting using Health Check
Last Updated: 19/03/2026The 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 variables, it may...
Email troubleshooting
Last Updated: 19/03/2026In 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. This means that...
Troubleshoot PHP errors
Last Updated: 19/03/2026PHP 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. Note: This document is meant to serve as a helpful guide for advanced troubleshooting;...
Troubleshoot “My site is down”
Last Updated: 19/03/2026WordPress 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...
Troubleshoot AJAX issues
Last Updated: 19/03/2026Asynchronous 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...
Troubleshoot JavaScript errors
Last Updated: 19/03/2026JavaScript 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. Note: This document is meant to serve as a helpful guide for advanced troubleshooting; however, the procedures described are beyond the scope of our support policy and we cannot...
Troubleshoot payment errors
Last Updated: 19/03/2026Troubleshooting 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 encountering errors, these...
Finding PHP error logs
Last Updated: 19/03/2026PHP 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 records PHP fatal...
Completed Order Email doesn’t Contain Download Links
Last Updated: 19/03/2026On 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 SQL table called wp_woocommerce_downloadable_product_permissions is...
Cross-browser testing your site
Last Updated: 19/03/2026Testing 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. Note: This document is meant to serve as...
WooCommerce pages not displaying
Last Updated: 19/03/2026If 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 were used for account...
How to test for plugin and theme conflicts
Last Updated: 19/03/2026What 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...
HTTP 500 Internal Server Error — getting more information
Last Updated: 19/03/2026An 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)
Last Updated: 19/03/2026If 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. Questions...
session_start warnings
Last Updated: 19/03/2026If 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
Last Updated: 19/03/2026There 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 above the line that says, /*...
SSL, HTTPS, and WooCommerce
Last Updated: 19/03/2026This 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...
Troubleshooting Core Taxes
Last Updated: 19/03/2026This 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 use this section to set up...
SSL by proxy problems (Network Solutions)
Last Updated: 19/03/2026Hosts 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 use of server-side variables...
ssl_error_rx_record_too_long
Last Updated: 19/03/2026This 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 can...
Fatal error: Call to undefined function is_woocommerce_active()
Last Updated: 19/03/2026Currently, 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. If you have not activated your...
Privacy
Last Updated: 19/03/2026Information about what customer data may be collected and shared when a store uses extensions sold on WooCommerce.com. For information about your privacy when making purchases on WooCommerce.com, visit automattic.com/privacy. Documents Privacy considerations when using official shipping extensions To take advantage of real-time shipping rates, fulfill orders, and track shipments, certain shipping-related information about you and...
Change to Use Terms and Privacy Policy – December 2020
Last Updated: 19/03/2026What has changed? As of January 1, 2021, your agreement (the WooCommerce Use Terms) will be merged into the WordPress.com Terms of Service, and the company responsible for your personal information (as mentioned in our Privacy Policy) will change. Also, as per the same date, agreements with Prospress (AutomateWoo) will be merged into the WordPress.com Terms of Service. AutomateWoo is...
Change to Use Terms and Privacy Policy – July 2020
Last Updated: 19/03/2026Note: This has been superseded by the December 2020 update – please read more at the Change to Use Terms and Privacy Policy – December 2020. What Has Changed? As of August 1, 2020, your agreement (the WooCommerce Use Terms) will no longer be with Bubblestorm Management (Pty) Ltd., and the company responsible for your personal information...
Privacy and the WooCommerce Marketplace
Last Updated: 19/03/2026When a WooCommerce site uses an extension or theme offered in the WooCommerce.com Marketplace, they may be: This documentation describes which data from your customers may be collected and shared when you use extensions and themes sold on WooCommerce.com. This resource provides a general overview; if you have specific concerns about a particular product, we encourage you...
Privacy considerations when using official shipping extensions
Last Updated: 19/03/2026To take advantage of real-time shipping rates, fulfill orders, and track shipments, certain shipping-related information about you and your customers — including shopping carts, orders, and the configuration of your site — will be passed to the respective service. We recommend that store owners disclose that they are sharing information with shipping providers in their...
Privacy considerations when using official payments extensions
Last Updated: 19/03/2026If you choose to accept payments via a payment gateway like Stripe or PayPal, some of your — and your customers’ — data will be passed to the respective third party. This includes information required to process or support the payment, such as the purchase total and your customer’s billing information. We recommend that store...
Frequently Asked Questions
Last Updated: 19/03/2026Documents Frequently Asked Questions This page contains answers to Frequently Asked Questions related to WooCommerce, products sold on WooCommerce.com, and account management on WooCommerce.com. Email and SMTP providers This document aims to explain how email works, and also explains the role Simple Mail Transfer Protocol (SMTP) providers play in ensuring your WooCommerce store’s emails are...
Frequently Asked Questions
Last Updated: 19/03/2026This page contains answers to Frequently Asked Questions related to WooCommerce, products sold on WooCommerce.com, and account management on WooCommerce.com. General Questions What is WordPress? WordPress is a Content Management System (CMS). It’s software that helps you create, manage, and share your content on the web. Currently, WordPress has two flavors, WordPress.com (hosted) and WordPress.org (self-hosted). Products purchased on...
Email and SMTP providers
Last Updated: 19/03/2026This document aims to explain how email works, and also explains the role Simple Mail Transfer Protocol (SMTP) providers play in ensuring your WooCommerce store’s emails are delivered to your customers. Understanding how email works is a big part of keeping these emails running smoothly. Related documents for additional reference: How does email work? Imagine sending an...
Extension translations
Last Updated: 19/03/2026We are beginning to translate WooCommerce-owned extensions into multiple languages, starting with Spanish. Supported languages are highlighted on each product page, with country flags helping to identify whether the extension is supported in that location. We will not force vendors to provide translations of their extensions. If a vendor would like to provide translations of...
PCI-DSS compliance and WooCommerce
Last Updated: 19/03/2026What is PCI-DSS? The Payment Card Industry Data Security Standard (PCI-DSS) is a set of actionable rules established by the Payment Card Industry Security Standards Council (PCI SSC). Its primary goal is to promote consistent global data security practices and reduce credit card fraud. These rules apply to anyone who stores, processes, or transmits cardholder data. For...
SSL FAQ
Last Updated: 19/03/2026Get answers to frequently asked questions about using secure socket layer (SSL) certificates with WooCommerce and WordPress. Is SSL set up correctly on my website? Use Qualys SSL Labs SSL Server Test to determine whether your website is configured correctly after installing an SSL certificate. This test also reviews and grades the security of your web server...
WooCommerce guidelines for CBD and other hemp-derived products
Last Updated: 19/03/2026Scope of guidance These guidelines apply to sites hosted at WordPress.com or on Pressable. These guidelines apply to store owners who’d like to sell cannabidiol (CBD) and other hemp-derived products on a site hosted at WordPress.com or on Pressable. Note: If you’re only using the free, open source WooCommerce software (the core plugin) on a self-hosted site, you can have Jetpack or ongoing WooCommerce.com...
Abusive content on a store built with WooCommerce
Last Updated: 19/03/2026WooCommerce is a free, open-source software product that is available for anyone to download and use with their self-hosted WordPress site. While this means a lot of wonderful products are sold through our software, the open-source and distributed nature of WooCommerce means that there may also be stores using the platform for purposes that are malicious or...
WooCommerce and Highly-Regulated Products
Last Updated: 19/03/2026This document focuses on whether WooCommerce can be used to sell products that are highly regulated and/or legally restricted. This includes products listed here, which are prohibited on WordPress.com but are permitted to some extent on our open source WooCommerce plugin, subject to the following guidelines. Can WooCommerce be used to sell highly-regulated products? Yes, you...
Built with WooCommerce – Did not get my order or refund
Last Updated: 19/03/2026Ordering something online and getting an email that the product is on its way is an exciting feeling. But what if you never receive what you ordered? Or are expecting a refund for a returned product? What if you changed your mind and now you want to cancel the order? Because we have no access...
Create a new administrator account in WordPress
Last Updated: 19/03/2026To provide the quickest support in trickier cases our Happiness Engineers may request an Administrator account on your site to take a closer look at the issue. If that scenario arises, we’ll request that you create a temporary admin login for us, which should be deleted once we are finished. Note:Please note that to comply with GDPR rules, you...
Taxes Report
Last Updated: 19/03/2026The Taxes Report provides insight into taxes collected on your store. All Taxes View By default, the Taxes Report displays the All Taxes view. All taxes that have been collected in the specified date range will be shown. Comparison Mode By selecting “Comparison” in the “Show” dropdown, search for multiple tax codes to display report...
WooCommerce Cost of Goods Sold (COGS)
Last Updated: 19/03/2026WooCommerce 9.9 introduces the Cost of Goods Sold (COGS) feature, which enables you to track the direct costs associated with the products sold in your store. This feature provides the necessary data to calculate accurate profit margins, empowering store owners to make data-driven decisions for pricing, marketing, inventory management, and more. As of WooCommerce 10.3, the Cost...
Remove Related Products Output
Last Updated: 19/03/2026This is a Developer level doc. If you are unfamiliar with code/templates and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our Support Policy. Add this code to your child theme’s functions.php file or via a plugin that allows custom functions to be added, such as the Code snippets plugin. Avoid adding custom...
Change number of related products output
Last Updated: 19/03/2026Scope of support:We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or a WooCommerce developer on Codeable. Add code to your child theme’s functions.php file or via a plugin that allows custom functions to be added, such as the Code...
How to configure caching plugins for WooCommerce
Last Updated: 19/03/2026Excluding pages from the cache Oftentimes if using caching plugins they'll already exclude these pages. Otherwise make sure you exclude the following pages from the cache through your caching systems respective settings. These pages need to stay dynamic since they display information specific to the current customer and their cart. Excluding WooCommerce session from the...