PHPackages                             woocommerce/woocommerce-blocks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. woocommerce/woocommerce-blocks

AbandonedArchivedWordpress-plugin

woocommerce/woocommerce-blocks
==============================

WooCommerce blocks for the Gutenberg editor.

11.7.0(2y ago)407921.3k—0%215[16 issues](https://github.com/woocommerce/woocommerce-blocks/issues)[24 PRs](https://github.com/woocommerce/woocommerce-blocks/pulls)1GPL-3.0-or-laterTypeScript

Since Dec 4Pushed 2y ago85 watchersCompare

[ Source](https://github.com/woocommerce/woocommerce-blocks)[ Packagist](https://packagist.org/packages/woocommerce/woocommerce-blocks)[ Docs](https://woocommerce.com/)[ RSS](/packages/woocommerce-woocommerce-blocks/feed)WikiDiscussions trunk Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (547)Used By (1)

📣 Announcement: New documentation location
==========================================

[](#-announcement-new-documentation-location)

The documentation for WooCommerce Blocks has moved to the [WooCommerce monorepo](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce-blocks/docs/).

Please refer to the documentation in the new location as the files in this repository will no longer be updated and the repository will be archived.

---

WooCommerce Blocks
===================

[](#woocommerce-blocks-)

[![Latest Tag](https://camo.githubusercontent.com/7424d7dc9b1187db70bb7dad70bb4bc1194b9bad9ce6d249793c90ccdf405044/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f776f6f636f6d6d657263652f776f6f636f6d6d657263652d677574656e626572672d70726f64756374732d626c6f636b2e7376673f7374796c653d666c6174266c6162656c3d4c6174657374253230546167)](https://github.com/woocommerce/woocommerce-gutenberg-products-block/releases)[![View](https://camo.githubusercontent.com/ad67e3af5b4216b33100b77875dc5dd4fff45b51b24f8d18392e3cbc478c3a3e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50726f6a656374253230436f6d706f6e656e74732d627269676874677265656e2e7376673f7374796c653d666c6174)](https://woocommerce.github.io/woocommerce-blocks/)[![JavaScript and CSS Linting](https://github.com/woocommerce/woocommerce-gutenberg-products-block/workflows/JavaScript%20and%20CSS%20Linting/badge.svg?branch=trunk)](https://github.com/woocommerce/woocommerce-gutenberg-products-block/workflows/JavaScript%20and%20CSS%20Linting/badge.svg?branch=trunk)[![PHP Coding Standards](https://github.com/woocommerce/woocommerce-gutenberg-products-block/workflows/PHP%20Coding%20Standards/badge.svg?branch=trunk)](https://github.com/woocommerce/woocommerce-gutenberg-products-block/workflows/PHP%20Coding%20Standards/badge.svg?branch=trunk)[![Unit Tests](https://github.com/woocommerce/woocommerce-blocks/workflows/E2E%20tests/badge.svg?branch=trunk)](https://github.com/woocommerce/woocommerce-blocks/workflows/E2E%20tests/badge.svg?branch=trunk)[![E2E Tests](https://github.com/woocommerce/woocommerce-blocks/workflows/Unit%20Tests/badge.svg?branch=trunk)](https://github.com/woocommerce/woocommerce-blocks/workflows/Unit%20Tests/badge.svg?branch=trunk)

This is the feature plugin for WooCommerce + the Gutenberg. This plugin serves as a space to iterate and explore new Blocks and updates to existing blocks for WooCommerce, and how WooCommerce might work with the block editor.

Use this plugin if you want access to the bleeding edge of available blocks for WooCommerce. However, stable blocks are bundled into WooCommerce, and can be added from the "WooCommerce" section in the block inserter.

- [WCCOM product page](https://woocommerce.com/products/woocommerce-gutenberg-products-block/)
- [User documentation](https://docs.woocommerce.com/document/woocommerce-blocks/)

Table of Contents
------------------

[](#table-of-contents-)

- [Documentation](#documentation)
    - [Code Documentation](#code-documentation)
- [Installing the plugin version](#installing-the-plugin-version)
- [Installing the development version](#installing-the-development-version)
- [Getting started with block development](#getting-started-with-block-development)
- [Long-term vision](#long-term-vision)

Documentation
-------------

[](#documentation)

To find out more about the blocks and how to use them, [check out the documentation on WooCommerce.com](https://docs.woocommerce.com/document/woocommerce-blocks/).

If you want to see what we're working on for future versions, or want to help out, read on.

### Code Documentation

[](#code-documentation)

- [Blocks](./assets/js/blocks) - Documentation for specific Blocks.
- [Editor Components](assets/js/editor-components) - Shared components used in WooCommerce blocks for the editor (Gutenberg) UI.
- [WooCommerce Blocks Handbook](./docs) - Documentation for designers and developers on how to extend or contribute to blocks, and how internal developers should handle new releases.
- [WooCommerce Blocks Storybook](https://woocommerce.github.io/woocommerce-blocks/) - Contains a list and demo of components used in the plugin.

Installing the plugin version
-----------------------------

[](#installing-the-plugin-version)

We release a new version of WooCommerce Blocks onto WordPress.org every few weeks, which can be used as an easier way to preview the features.

> Note: The plugin follows a policy of supporting the "L0" strategy for version support. What this means is that the plugin will require the most recent version of WordPress. It will also require the most recent version of WooCommerce core at the time of a release. You can read more about [this policy here](https://developer.woocommerce.com/?p=9998).

1.Ensure you have the latest available versions of WordPress and WooCommerce installed on your site. 2. The plugin version is available on WordPress.org. [Download the plugin version here.](https://wordpress.org/plugins/woo-gutenberg-products-block/)3. Activate the plugin.

Installing the development version
----------------------------------

[](#installing-the-development-version)

1. Ensure you have the latest versions of WordPress and WooCommerce installed on your site.
2. Get a copy of this plugin using the green "Clone or download" button on the right.
3. Make sure you're using Node.js v16.15. If you use a Node version management tool such as `nvm` or `n`, you can do so by running `nvm use` or `n auto`, respectively.
4. `npm install` to install the dependencies.
5. `composer install` to install core dependencies.
6. To compile the code, run any of the following commands
    1. `npm run build` (production build).
    2. `npm run dev` (development build).
    3. `npm start` (development build + watching for changes).
7. Activate the plugin.

The source code is in the `assets/` folder, and the compiled code is stored into `build/`.

Getting started with block development
--------------------------------------

[](#getting-started-with-block-development)

Run through the ["Writing Your First Block Type" tutorial](https://developer.wordpress.org/block-editor/how-to-guides/block-tutorial/writing-your-first-block-type/) for a quick course in block-building.

For deeper dive, try looking at the [core blocks code,](https://github.com/WordPress/gutenberg/tree/master/packages/block-library/src) or see what [components are available.](https://github.com/WordPress/gutenberg/tree/master/packages/components/src)

To begin contributing to the WooCommerce Blocks plugin, see our [getting started guide](./docs/contributors/getting-started.md) and [developer handbook](./docs/README.md).

Other useful docs to explore:

- [`InnerBlocks`](https://github.com/WordPress/gutenberg/blob/master/packages/block-editor/src/components/inner-blocks/README.md)
- [`apiFetch`](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-api-fetch/)
- [`@wordpress/editor`](https://github.com/WordPress/gutenberg/blob/master/packages/editor/README.md)
- [`@wordpress/create-block`](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-create-block/)

Long-term vision
----------------

[](#long-term-vision)

WooCommerce Blocks are the easiest, most flexible way to build your store's user interface and showcase your products.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity59

Moderate usage in the ecosystem

Community39

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor5

5 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

288

Last Release

895d ago

Major Versions

v8.9.3 → v9.3.02023-01-04

v8.9.4 → v9.1.42023-01-05

9.9.0 → 10.0.02023-04-11

9.8.5 → 10.0.32023-04-21

10.9.3 → 11.0.02023-08-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/d1f9b32f9677791fbef38b00c9225e05800f525b3b13872b118fd344a58350a0?d=identicon)[woocommerce](/maintainers/woocommerce)

![](https://www.gravatar.com/avatar/8295774fc174b6a5b9bd960709949f4de88cd0b8708d711dc5b6676693d41432?d=identicon)[mikejolley](/maintainers/mikejolley)

---

Top Contributors

[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (948 commits)")[![Aljullu](https://avatars.githubusercontent.com/u/3616980?v=4)](https://github.com/Aljullu "Aljullu (723 commits)")[![mikejolley](https://avatars.githubusercontent.com/u/90977?v=4)](https://github.com/mikejolley "mikejolley (663 commits)")[![gigitux](https://avatars.githubusercontent.com/u/4463174?v=4)](https://github.com/gigitux "gigitux (350 commits)")[![opr](https://avatars.githubusercontent.com/u/5656702?v=4)](https://github.com/opr "opr (346 commits)")[![nerrad](https://avatars.githubusercontent.com/u/1429108?v=4)](https://github.com/nerrad "nerrad (335 commits)")[![senadir](https://avatars.githubusercontent.com/u/6165348?v=4)](https://github.com/senadir "senadir (279 commits)")[![albarin](https://avatars.githubusercontent.com/u/186112?v=4)](https://github.com/albarin "albarin (241 commits)")[![dinhtungdu](https://avatars.githubusercontent.com/u/5423135?v=4)](https://github.com/dinhtungdu "dinhtungdu (181 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (167 commits)")[![ryelle](https://avatars.githubusercontent.com/u/541093?v=4)](https://github.com/ryelle "ryelle (158 commits)")[![nielslange](https://avatars.githubusercontent.com/u/3323310?v=4)](https://github.com/nielslange "nielslange (154 commits)")[![kmanijak](https://avatars.githubusercontent.com/u/20098064?v=4)](https://github.com/kmanijak "kmanijak (114 commits)")[![claudiulodro](https://avatars.githubusercontent.com/u/7317227?v=4)](https://github.com/claudiulodro "claudiulodro (103 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (101 commits)")[![tarhi-saad](https://avatars.githubusercontent.com/u/14235870?v=4)](https://github.com/tarhi-saad "tarhi-saad (93 commits)")[![haszari](https://avatars.githubusercontent.com/u/4167300?v=4)](https://github.com/haszari "haszari (90 commits)")[![thealexandrelara](https://avatars.githubusercontent.com/u/20469356?v=4)](https://github.com/thealexandrelara "thealexandrelara (90 commits)")[![danieldudzic](https://avatars.githubusercontent.com/u/905781?v=4)](https://github.com/danieldudzic "danieldudzic (87 commits)")[![ralucaStan](https://avatars.githubusercontent.com/u/1628454?v=4)](https://github.com/ralucaStan "ralucaStan (86 commits)")

---

Tags

gutenberghacktoberfestwoocommercewoocommerce-blockswordpressblockswoocommercegutenberg

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/woocommerce-woocommerce-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/woocommerce-woocommerce-blocks/health.svg)](https://phpackages.com/packages/woocommerce-woocommerce-blocks)
```

###  Alternatives

[automattic/jetpack

Jetpack supercharges your self‑hosted WordPress site with the awesome cloud power of WordPress.com

3621.9k](/packages/automattic-jetpack)[infinum/eightshift-libs

WordPress libs developed by Eightshift team to use in modern WordPress.

63118.9k3](/packages/infinum-eightshift-libs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
