Skip to main content

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. Before starting work, comment on the issue (particularly when it already has an assignee) to avoid duplicate effort and check that it's been triaged by the maintainers. If you're proposing a new feature or significant change, open an issue first to discuss it.

  2. Run tests locally - Some 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​

Use of your personal data

We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.