WooCommerce is the world’s most popular open-source eCommerce solution.

Our core platform is free, flexible, and amplified by a global community. The freedom of open-source means you retain full ownership of your store’s content and data forever.

Whether you’re launching a business, taking brick-and-mortar retail online, or developing sites for clients, use WooCommerce for a store that powerfully blends content and commerce.

Built-in tools and popular integrations help you efficiently manage your business operations. Many services are free to add with a single click via the optional Setup Wizard.

Grow your business, add features, and monitor your store on the go

WooCommerce means business. Keep tabs on the performance metrics most important to you with WooCommerce Admin – a powerful, customizable central dashboard for your store.

Expand your audience across marketing and social channels with Google Ads, HubSpot, Mailchimp, and Facebook integrations. You can always check out the in-dashboard Marketing Hub for fresh ideas and tips to help you succeed.

Enhance store functionality with hundreds of free and paid extensions from the official WooCommerce Marketplace. Our developers vet each new extension and regularly review existing inventory to maintain Marketplace quality standards. We are actively looking for products that help store builders create successful stores.

Manage your store from anywhere with the free WooCommerce mobile app (Android and iOS). Spoiler alert: Keep an ear out for the slightly addictive “cha-ching” notification sound each time you make a new sale!

Own and control your store data – forever

With WooCommerce, your data belongs to you. Always.

If you opt to share usage data with us, you can feel confident knowing that it’s anonymized and kept secure. Choose to opt-out at any time without impacting your store.

Unlike hosted eCommerce solutions, WooCommerce store data is future-proof; should you wish to migrate to a different platform, you’re free to export all your content and take your site wherever you choose. No restrictions.

Why developers choose (and love) WooCommerce

Developers can use WooCommerce to create, customize, and scale a store to meet a client’s exact specifications, making enhancements through extensions or custom solutions.

  • Leverage hooks and filters to modify or create functionality.
  • Integrate virtually any service using a robust REST API and webhooks.
  • Design and build custom content blocks with React.
  • Inspect and modify any aspect of the core plugin code.
  • Speed up development with a lightning-fast CLI.

The core platform is tested rigorously and often, supported by a dedicated development team working across time zones. Comprehensive documentation is updated with each release, empowering you to build exactly the store required.

Be part of our growing international community

WooCommerce has a large, passionate community dedicated to helping merchants succeed, and it’s growing fast.

There are WooCommerce Meetups in locations around the world that you can attend for free and even get involved in running. These events are a great way to learn from others, share your expertise, and connect with like-minded folks.

WooCommerce also has a regular presence at WordCamps across the globe – we’d love to meet you.

Contribute and translate

WooCommerce is developed and supported by Automattic, the creators of WordPress.com and Jetpack. We also have hundreds of independent contributors, and there’s always room for more. Head to the WooCommerce GitHub Repository to find out how you can pitch in.

WooCommerce is translated into multiple languages, including Danish, Ukrainian, and Persian. Help localize WooCommerce even further by adding your locale – visit translate.wordpress.org.



This plugin provides 16 blocks.

  • Newest Products
  • Best Selling Products
  • Hand-picked Products
  • Filter Products by Price
  • Active Product Filters
  • Products by Tag
  • Products by Category
  • Product Categories List
  • Product Search
  • Filter Products by Attribute
  • Featured Product
  • Reviews by Category
  • Reviews by Product
  • All Reviews
  • Featured Category
  • On Sale Products


Minimum Requirements

  • PHP 7.2 or greater is recommended
  • MySQL 5.6 or greater is recommended

Visit the WooCommerce server requirements documentation for a detailed list of server requirements.

Automatic installation

Automatic installation is the easiest option — WordPress will handles the file transfer, and you won’t need to leave your web browser. To do an automatic install of WooCommerce, log in to your WordPress dashboard, navigate to the Plugins menu, and click “Add New.”

In the search field type “WooCommerce,” then click “Search Plugins.” Once you’ve found us, you can view details about it such as the point release, rating, and description. Most importantly of course, you can install it by! Click “Install Now,” and WordPress will take it from there.

Manual installation

Manual installation method requires downloading the WooCommerce plugin and uploading it to your web server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.


Automatic updates should work smoothly, but we still recommend you back up your site.

If you encounter issues with the shop/category pages after an update, flush the permalinks by going to WordPress > Settings > Permalinks and hitting “Save.” That should return things to normal.

Sample data

WooCommerce comes with some sample data you can use to see how products look; import sample_products.xml via the WordPress importer. You can also use the core CSV importer or our CSV Import Suite extension to import sample_products.csv


Where can I find WooCommerce documentation and user guides?

For help setting up and configuring WooCommerce, please refer to Getting Started and the New WooCommerce Store Owner Guide.

For extending or theming WooCommerce, see our codex, as well as the Plugin Developer Handbook.

Where can I get help or talk to other users about WooCommerce Core?

If you get stuck, you can ask for help in the WooCommerce Support Forum by following these guidelines, reach out via the WooCommerce Community Slack, or post in the WooCommerce Community group on Facebook.

Where can I get help for extensions I have purchased on WooCommerce.com?

For assistance with paid extensions from the WooCommerce.com Marketplace: first, review our self-service troubleshooting guide. If the problem persists, kindly log a support ticket via our helpdesk. Our dedicated Happiness Engineers aim to respond within 24 hours.

I’m having trouble logging in to WooCommerce.com – what now?

First, troubleshoot common login issues using this helpful step-by-step guide. Still not working? Get in touch with us.

Will WooCommerce work with my theme?

Yes! WooCommerce will work with any theme but may require some additional styling. If you’re looking for a theme featuring deep WooCommerce integration, we recommend Storefront.

How do I update WooCommerce?

We have a detailed guide on How To Update WooCommerce.

My site broke – what do I do?

Start by diagnosing the issue using our helpful troubleshooting guide.

If you noticed the error after updating a theme or plugin, there might be compatibility issues between it and WooCommerce. If the issue appeared after updating WooCommerce, there could be a conflict between WooCommerce and an outdated theme or plugin.

In both instances, we recommend running a conflict test using Health Check (which allows you to disable themes and plugins without affecting your visitors) or troubleshooting the issue using a staging site.

Where can I report bugs?

Report bugs on the WooCommerce GitHub repository. You can also notify us via our support forum – be sure to search the forums to confirm that the error has not already been reported.

Where can I request new features, themes, and extensions?

Request new features and extensions and vote on existing suggestions on our official ideas board. Our Product teams regularly review requests and consider them valuable for product planning.

WooCommerce is awesome! Can I contribute?

Yes, you can! Join in on our GitHub repository and follow the development blog to stay up-to-date with everything happening in the project.

Where can I find REST API documentation?

Extensive WooCommerce REST API Documentation is available on GitHub.

My question is not listed here. Where can I find more answers?

Check out Frequently Asked Questions for more.


May 8, 2021
Great plugin. Code is completely development friendly. Working without any hesitation. Keep it up!
May 2, 2021
Can never ask them for any support at all. No matter how many times you request. No answer.
April 25, 2021
HI there, Overall an excellent plugin however when I updated to 5.2.2 the reviews/ comments stopped working. An error message was returned after the Captcha was entered by the reviewer. I returned to 5.2.0 and user reviews worked again. Thoughts? Lori
April 24, 2021
This really is a very good plugin, as a starter for a e-commerce webshop, or even for advanced users in the business. I genuinely love the flexibility it still has.
April 22, 2021
Today I am launching my online marketplace so quickly only because of this plugin This plugin forms the backbone of my marketplace and the features are easy to understand and use for beginners. I will recommend this plugin to every entrepreneur. Thumbs up.
Read all 3,725 reviews

Contributors & Developers

“WooCommerce” has been translated into 65 locales. Thank you to the translators for their contributions.

Translate “WooCommerce” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


5.2.2 2021-04-15


  • Fix – Can’t grant permission for download from order details page. #29691

5.2.1 2021-04-14


  • Update – WooCommerce Blocks package 4.7.2. #29660

WooCommerce Blocks – 4.7.2

  • Fix – Check if Cart and Checkout are registered before removing payment methods. (4056)

5.2.0 2021-04-13


  • Add – Filter woocommerce_product_recount_terms to allow/prevent recounting of product terms. #29281
  • Add – Result return array to the checkout_place_order_success callback to allow 3rd party to manipulate results. #29232
  • Dev – Fix miscellaneous typos in docblocks. #29285
  • Dev – Added woocommerce_ajax_order_items_removed hook. #29241
  • Dev – Fix usage of docker-compose (wc-e2e) commands in e2e tests when running them within WSL2. #29207
  • Dev – Fixes to documentation of WC_Shipping_Rate. #29117
  • Dev – Add tracks event when a user clicks on the links of the WooCommerce Status widget. #29109
  • Dev – Track the number of installations of WooCommerce Payments via that extensions banner for stores that have opted in to tracking. #29052
  • Dev – Added woocommerce_ajax_order_items_removed hook. #28936
  • Dev – Add tracking of woocommerce_admin_disabled usage. #28535
  • Enhancement – Add support for the low stock threshold for variations. #29345
  • Enhancement – Clean up of major version update compatibility warnings. #29200
  • Enhancement – Add a new dashboard widget to promote users to finish onboarding tasks. #29174
  • Enhancement – Update the Woo widget net sales link and logic to use the new analytics page and data. #29149
  • Enhancement – Added the body class woocommerce-shop to the shop page, so that it can be targeted via CSS. (#28724). #29051
  • Enhancement – Make sure downloadable file paths are properly recognized for strengthened security. #28699
  • Enhancement – Delay the registration of data exporters and erasers to avoid multiple language files from being loaded. #28078
  • Fix – Offsets not calculated correctly sometimes on select2 dropdowns causing usability issues. #29397
  • Fix – Handle errors in fault installations of PHP Intl. #29391
  • Fix – Cart page calculate shipping fields not showing correct fields based on location. #29282
  • Fix – Product categories widget item count not always showing the correct number. #29281
  • Fix – Updated include/rest-api/Controllers/Version3/class-wc-rest-shipping-zone-methods-controller.php to include a item schema function which appends support for order and class type values. #29218
  • Fix – Check if variation_id if belongs to the parent product while adding products to the cart. #29208
  • Fix – Reduce the number of ajax calls used when Geolocation (with Page Caching Enabled) mode is enabled. #29182
  • Fix – Don’t display the coupon form on checkouts requiring the customer to be logged in to checkout. #29151
  • Fix – If coupon_lines are specified within a REST API order update, return an error if coupon item IDs are also specified. #29146
  • Fix – Avoids duplicating the word ‘(optional)’ in the context of the Billing Address 2 field. #29136
  • Fix – PHP notice when checking out. #29133
  • Fix – Remove duplicate containers from the single and archive product pages. #29121
  • Fix – Wrong taxonomy caching in term and product attributes controllers. #29115
  • Fix – Make the parameters of the refund creation REST API behave as documented. #29099
  • Fix – Shipping methods with similar names could cause shipping method not selectable in order page. #29049
  • Fix – WC_Countries::get_formatted_address() not returning full name in correct order in some languages. #29008
  • Fix – add validation of the posted country codes on checkout. #28849
  • Fix – Correctly display pagination arrows on RTL languages. #28523
  • Fix – Invalid refund amount error on $0 refund when number of decimals is equal to 0. #27277
  • Fix – “Sale” badge misaligned on products when displaying 1 item per row. #29425
  • Fix – Revert a replacement of wp_redirect to wp_safe_redirect in WC_Checkout::process_order_payment that caused issues in the default PayPal interface. #29459
  • Fix – Don’t remove existing coupons from order when an invalid REST API request for updating coupons is submitted. #29474
  • Fix – Wrong logic for including or excluding the payments step in the list of completed tasks in the onboarding wizard. #29518
  • Fix – Error when loading the admin dashboard while the admin package was disabled. #29613
  • Fix – “” is not a valid country code” error when no billing/shipping country specified (e.g. when using PayPal checkout). #29606
  • Fix – Sanitize tax class and display errors in admin while creating tax classes.
  • Fix – Check if a verified product owner is required before placing a review.
  • Fix – Make product name escaping consistent in the front-end.
  • Tweak – Added the Mercado Pago logo into the assets/images folder in order to use it in the payments setup task. #29365
  • Tweak – Update the contributor guidelines. #29150
  • Tweak – Introduced phone number input validation. #27242
  • Tweak – Escape short description.
  • Update – WooCommerce Admin package 2.1.5. #29577
  • Update – WooCommerce Blocks package 4.7.0. #29406

WooCommerce Admin – 2.1.0 & 2.1.1 & 2.1.2 & 2.1.3 & 2.1.4 & 2.1.5

  • Add – Add navigation intro modal. #6367
  • Add – CES track settings tab on updating settings #6368
  • Add – Core settings redirection to new settings pages #6091
  • Add – Favorites tooltip to the navigation #6312
  • Add – Favoriting extensions client UI #6287
  • Add – Remove CES actions for adding and editing a product and editing an order #6355
  • Add – Settings client pages #6092
  • Add – Settings feature and pages #6089
  • Dev – Add filter to allow enabling the WP toolbar within the new navigation. #6371
  • Dev – Add navigation favorites data store #6275
  • Dev – Add unit tests to Navigation’s Container component. #6344
  • Dev – Allow highlight tooltip to use body tag as parent. #6309
  • Dev – Change siteUrl to homeUrl on navigation site title #6240
  • Dev – Fix the react state update error on homescreen. #6320
  • Dev – Refactor head and body heights #6247
  • Dev – Remove Google fonts and material icons. #6343
  • Dev – Use box sizing and padding to fix nav and admin menu styling #6335
  • Enhancement – Move capability checks to client #6365
  • Enhancement – Move favorited menu items to primary menu #6290
  • Enhancement – Navigation: Add test to container component #6344
  • Enhancement – override wpbody styles when nav present #6354
  • Feature – Increase target audience for business feature step. #6508
  • Fix – Add check for navigating being enabled. #6462
  • Fix – Add customer name column to CSV export #6556
  • Fix – Add guard to “Deactivate Plugin” note handlers to prevent fatal error. #6532
  • Fix – Adding New Zealand and Ireland to selective bundle option, previously missed. #6649
  • Fix – Broken link anchors to online documentation. #6455
  • Fix – Check if tax was successfully added before displaying notice #6229
  • Fix – Correct a bug where the JP connection flow would not happen when installing JP in the OBW. #6521
  • Fix – Crash of Analytics > Settings page when Gutenberg is installed. #6540
  • Fix – Display” option fails to collapse upon invoking “Help” option #6233
  • Fix – Email notes now are turned off by default #6324
  • Fix – Empty nav menu #6366
  • Fix – Enqueue scripts called incorrectly in php unit tests #6358
  • Fix – Hide tooltip in welcome modal #6142
  • Fix – Recommended Payment Banner missing in Safari #6375
  • Fix – Removal of core settings pages #6328
  • Fix – Removed @woocommerce/components/card from OBW #6374
  • Fix – Reset Navigation submenu before making Flyout #6396
  • Fix – Restore missing Correct the Klarna slug #6440
  • Fix – Top bar slightly overlaps wp-admin navigation on mobile #6292
  • Fix – update single column home screen width to 680px #6297
  • Fix – Update timing of InboxPanel state changes for the unread indicator #6246
  • Tweak – Enqueue beta features scripts on enqueue_scripts action instead of filter #6358
  • Tweak – Move admin menu manipulation from admin_head to admin_menu #6310
  • Tweak – Navigation: Migrate methods to admin_menu hook #6319
  • Tweak – New Settings: Turn off in dev mode #6348
  • Tweak – Order and styles updates to nav footer #6373
  • Tweak – Remove categories without menu items #6329
  • Tweak – Set international country feature flag off
  • Tweak – Set is_deleted from the database when instantiating a Note #6322
  • Tweak – Update inline documentation for navigation Screen class #6173
  • Tweak – Updates to copy and punctuation to be more conversational and consistent. #6298

WooCommerce Blocks – 4.5.0 & 4.6.0 & 4.7.0 & 4.7.1

  • Enhancement – Login links on the checkout should use the account page. (3844)
  • Enhancement – Prevent checkout linking to trashed terms and policy pages. (3843)
  • Enhancement – Improved nonce logic by moving nonces to cart routes only. (3812)
  • Enhancement – If coupons become invalid between applying to a cart and checking out, show the user a notice when the order is placed. (3810)
  • Enhancement – Improve design of cart and checkout sidebars. (3797)
  • Enhancement – Improve error displayed to customers when an item’s stock status changes during checkout. (3703)
  • Enhancement – Dev – Block Checkout will now respect custom address locales and custom country states via core filter hooks. (3662)
  • Enhancement – Update checkout block payment methods UI. (3439)
  • Enhancement – StoreAPI: Inject Order and Cart Controllers into Routes. (3871)
  • Enhancement – Update Panel component class names to follow guidelines. More info can be found in our theming docs: https://github.com/woocommerce/woocommerce-gutenberg-products-block/blob/18dd54f07262b4d1dcf15561624617f824fcdc22/docs/theming/class-names-update-460.md. (3860)
  • Enhancement – Refactor block type registration to support 3rd party integrations.
  • Enhancement – A new configuration property is available to registered payment methods for additional logic handling of saved payment method tokens. (3961)
  • Enhancement – Provided billing data to payment method extensions so they can decide if payment is possible. (3922)
  • Enhancement – Prevent errant payment methods from keeping Cart and Checkout blocks from loading. (3920)
  • Fix block elements that don’t play well with dark backgrounds. (3887)
  • Fix – JS warning if two cart products share the same name. (3814)
  • Fix – Align place order button to the right of the block. (3803)
  • Fix – Ensure special characters are displayed properly in the Cart sidebar. (3721)
  • Fix – Bug where the total price of items did not include tax in the cart and checkout blocks. (3851)
  • Fix – Handle out-of-stock product visibility setting in All Products block. (3859)
  • Fix – Show cart item subtotal instead of total in Cart and Checkout blocks (#3905)
  • Fix – Fix button styles in Twenty Nineteen theme. (3862)
  • Fix – Return correct sale/regular prices for variable products in the Store API. (3854)
  • Fix – Remove shadows from text buttons and gradient background from selects in some themes. (3846)
  • Fix – Hide Browse Shop link in cart block empty state when there is no shop page. (3845)
  • Fix – Remove extra padding from payment methods with no description. (3952)
  • Fix – “save payment” checkbox not showing for payment methods. (3950)
  • Fix – Cart preview when shipping rates are set to be hidden until an address is entered. (3946)
  • Fix – Sync cart item quantity if its Implicitly changed. (3907)
  • Fix – FSE not being visible when WC Blocks was enabled. (3898)
  • Fix – Ensure sale badges have a uniform height in the Cart block. (3897)
  • Note – Internally, this release has modified how AbstractBlock (the base class for all of our blocks) functions, and how it loads assets. AbstractBlock is internal to this project and does not seem like something that would ever need to be extended by 3rd parties, but note if you are doing so for whatever reason, your implementation would need to be updated to match. (3829)

See changelog for all versions.