Adding and Modifying Actions and Filters

WooCommerce is an open source project and we actively encourage contributions from our developer community — including pull requests that introduce new functionality. At the same time, we understand that it is not always clear what kind of changes we will or will not accept.

To help with this and to reduce unnecessary back-and-forth during the code review process, we have published a new guide outlining our expectations when introducing new actions and filter hooks (and, potentially, changes to existing ones).

The details

We’ve published our new guidelines in the project wiki:

github.com/woocommerce/woocommerce/wiki/Adding-Actions-and-Filters

Ultimately, these remain guidelines rather than hard rules. Sometimes exceptions should be made, and the team remains open to those. Nonetheless, this guide should help foster a shared understanding of our general expectations.

How can I tell if this affects me?

If you work with WooCommerce and you think you may contribute to the project in the future — or you have done so in the past and have thoughts on the matter — please take a moment to review the new guidance.

What action should I take?

No action is needed, but we do invite feedback and suggestions that will help us to improve this and other aspects of our documentation.

Thanks!