Testing

Setting up your test environment and writing tests when contributing to WooCommerce Core are essential parts of our development pipeline. The links below are also included in our Contributing Guidelines on GitHub.

If you have questions about testing, reach out to the developer community in our public channels: Developer Blog, GitHub Discussions, or Community Slack.

Unit testing

Unit tests run against the WooCommerce PHP test suite. The recommended local setup uses wp-env.

End-to-end testing

End-to-end tests are powered by Playwright. The test site is spun up using wp-env.

API testing

API tests are part of the Playwright suite and use the same wp-env test environment as end-to-end tests.

PHP version coverage

Use the PHP version guidelines to understand how to choose representative, minimum, and latest PHP versions, and where each belongs in E2E and PHP unit testing.

Testing instructions

When opening a pull request, use the testing instructions guide to write clear steps that cover the behavior changed in the PR.

Calls for testing

Keep tabs on calls for testing on our developer blog, and read our beta testing instructions to help us build new features and enhancements.