Community contributions
WooCommerce is open-source software that welcomes community contributions. To help us review your contribution quickly, please follow these guidelines.
Before you submit
-
Link to a related issue - If one exists, reference it in your PR. If you're proposing a new feature or significant change, open an issue first to discuss it.
-
Run tests locally - Som of the CI workflows are not automatically triggered for community contributions, so please verify your changes pass relevant tests and linting locally before submitting.
-
Consolidate related changes - If you have multiple similar fixes (e.g., typos, documentation updates), combine them into a single PR when appropriate.
PR requirements
When you open a PR, you'll receive an immediate review from our AI code reviewer. Before a maintainer reviews your PR, please:
- Fill out the entire PR template - Include a clear description of your changes and test steps.
- Respond to all AI review feedback - Review automated feedback and either address it, or explain why it does not apply.
- Confirm tests pass - Note in your PR that you've run the test suite locally.
AI-assisted contributions
We welcome AI-assisted contributions, but the same quality standards apply whether code is written by hand or with AI tools. As the contributor, you are responsible for:
- Understanding the code you submit
- Verifying the changes work as intended
- Following all contribution guidelines
What happens next
After you submit a PR that meets these requirements:
- A maintainer will triage your PR
- You may receive additional feedback or change requests
- Once approved, your PR will be merged into an upcoming release
If your PR needs changes, we'll add a needs: author feedback label. Please respond to feedback promptly to keep your contribution moving forward, as stale PRs with that label are automatically closed after a period of time.