Contributing to WooCommerce

Learn how to contribute to WooCommerce development through code, testing, documentation, and community support

WooCommerce powers millions of online stores across the internet, and your help making it even more awesome will be greatly appreciated. There are many ways to contribute to the project, from code contributions to testing and community support.

Ways to Contribute

You can contribute to WooCommerce in several meaningful ways:

Code Contributions

Submit fixes, improvements, and enhancements to the core plugin

Testing

Test open issues, pull requests, and beta releases

Translation

Help translate WooCommerce into your language

Community Support

Answer questions on support forums and help other users

Getting Started with Code Contributions

If you wish to contribute code, please follow these steps:

1. Read the Documentation

   Familiarize yourself with the project README and DEVELOPMENT.md

2. Set Up Your Environment

   Install the required prerequisites:

   • NVM for Node.js version management
   • PNPM for package management
   • PHP 7.4+
   • Composer for PHP dependencies
3. Fork and Clone

   Fork the WooCommerce repository and clone it locally

4. Install Dependencies

   Run the installation commands:

   nvm install
   pnpm install
   pnpm build
   
5. Make Your Changes

   Create a branch, make your changes, and ensure they follow our coding standards

6. Submit a Pull Request

   Push your changes and submit a pull request

Finding Issues to Work On

We use the good first issue label to mark issues that are suitable for new contributors. You can find all issues with this label here.

Before starting work on an issue, check the comments to see if someone else is already working on it. Consider leaving a comment to let others know you’re taking it on.

License and Copyright

WooCommerce is licensed under GPLv3+, and all contributions to the project will be released under the same license.

• You maintain copyright over any contribution you make
• By submitting a pull request, you agree to release that contribution under the GPLv3+ license
• Your code must support the minimum supported versions of PHP and WordPress shown in readme.txt

Community and Support

Where to Get Help

If you have questions about contributing or want to discuss your contribution:

• Slack: Join the #core channel in the WooCommerce community Slack
• GitHub Discussions: For broader discussions, use GitHub Discussions
• Office Hours: Sync with the team during scheduled office hours

Testing and Feedback

You can help by:

• Testing open issues or pull requests
• Testing WooCommerce beta versions and release candidates (announced on the WooCommerce development blog)
• Answering questions on the WP.org support forums

Translation

Help make WooCommerce available in your language by translating strings.

Security Disclosures

To disclose a security issue to our team, please submit a report via HackerOne. Do not open public GitHub issues for security vulnerabilities.

Feature Requests

The best place to submit feature requests is on our dedicated feature request page, where you can:

• Search for existing requests
• Vote for features you’d like to see
• Create new requests

For straightforward technical enhancements, you can also open a new issue on GitHub.

Code of Conduct

We are committed to fostering an open and welcoming environment. All contributors are expected to:

• Use welcoming and inclusive language
• Be respectful of differing viewpoints and experiences
• Gracefully accept constructive criticism
• Focus on what is best for the community
• Show empathy towards other community members

Unacceptable Behavior

Examples of unacceptable behavior include:

• The use of sexualized language or imagery and unwelcome sexual attention
• Trolling, insulting/derogatory comments, and personal or political attacks
• Public or private harassment
• Publishing others’ private information without explicit permission
• Other conduct which could reasonably be considered inappropriate in a professional setting

Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [e-mail]. All complaints will be reviewed and investigated promptly and fairly.

Next Steps

Ready to contribute? Check out these guides:

Coding Standards

Learn about PHP and JavaScript coding standards

Testing

Understand testing requirements and how to run tests

Git Workflow

Follow our Git workflow for branches, commits, and PRs