Content type: Handbook

  • Set Up a Testing Environment

    To test WordPress core tickets effectively, you need an environment where you can apply patches and run tests. Patches are created against the trunk branch, the development version of WordPress, not the stable release from wordpress.org/download, so you’ll need to work with the development codebase. This guide covers the options available for setting up a…

  • Run Automated Tests

    Automated tests are crucial for ensuring that changes to WordPress core do not introduce regressions. This guide covers how to run the PHP and End-to-End (E2E) test suites locally. Prerequisites Ensure a local testing environment is set up. See Set Up a Testing Environment. To learn how to apply patches before running tests, see Test…

  • User documentation process before a major version release

    With each WordPress release, there are documentation updates that need to be handled to keep the documentation provided for users up to date and informative. This work involves a few steps: Identifying the updates, writing the updates, reviewing the updates, and publishing the updates.  This work is done by the Documentation team, is tracked in…

  • Beginner’s Guide

    So you’ve heard about WP-CLI and want to try it out, but you’re not sure where to start? This guide is for you. No programming experience required! This guide is designed to be read from start to finish. Each section builds on the previous one, taking you from opening a terminal for the first time…

  • Common Tasks with WP-CLI

    Not sure what you can do with WP-CLI? This page showcases practical, everyday WordPress management tasks you can accomplish from the command line — with examples you can use right away. New to the command line? Start with the Beginner’s Guide first. Plugins Install a plugin wp plugin install contact-form-7 Install and activate a plugin…

  • Installing WP-CLI Packages

    WP-CLI packages are community-maintained projects built on WP-CLI. They can contain WP-CLI commands, but they can also just extend WP-CLI in some way. To find existing packages to install, take a look at Packagist. Installing a Package Use the wp package install command to install a package. Packages can be specified as: Composer package name…

  • WP-CLI Contributor Badge

    The WP-CLI Contributor Badge recognizes individuals who have made meaningful contributions to the WP-CLI project. This badge is displayed on a contributor’s WordPress.org profile and highlights their involvement in maintaining and improving WP-CLI. Eligibility criteria You may be eligible for the WP-CLI badge if you have made consistent and valuable contributions, including but not limited…

  • Test Chat Moderator Guide

    This guide helps moderators run Test Team Chat meetings. Use the structure and example phrases below as a reference. Pre-Meeting Preparation Before the meeting: 1. Review the meeting agenda published beforehand 2. Prepare any links or resources mentioned in the agenda 3. Have the Test Team Handbook open: https://github.com/WordPress/test-handbook 4. Note the scheduled start and…

  • WP Bench

    The official WordPress AI benchmark. Evaluate how well language models understand WordPress development—from core APIs and coding standards to plugin architecture and security best practices. Announcement post GitHub repository WP-Bench measures AI model capabilities across two dimensions: Knowledge — Multiple-choice questions testing WordPress concepts, APIs, and best practices Execution — Code generation tasks graded by a real…

  • WP AI Client

    Project Details Roadmap TBD Milestones tbd Repo WP AI Client (log bugs and enhancements to Trac) Goal The WP AI Client enables WordPress to communicate with generative AI models of varying capabilities via a uniform API. The WP AI Client is built on top of the PHP AI Client, and specifically adapted for the WordPress ecosystem.…