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

1. 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.

2. 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.

3. 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:

1. Fill out the entire PR template - Include a clear description of your changes and test steps.
2. Respond to all AI review feedback - Review automated feedback and either address it, or explain why it does not apply.
3. 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:

1. A maintainer will triage your PR
2. You may receive additional feedback or change requests
3. 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.

Getting help

• WooCommerce Community Slack
• Developer Documentation
• Open an Issue