The [block] command does not actually exist

[joshualip-plaudit]

Bug Report

• Yes, I reviewed the contribution guidelines.
• Yes, more specifically, I reviewed the guidelines on how to write clear bug reports.

Describe the current, buggy behavior
Per the online documentation (https://developer.wordpress.org/cli/commands/), a set of commands starting with block should exist.
However, upon running wp block type list (the command that I was interested in running), I was met with: Error: 'block' is not a registered wp command. See 'wp help' for available commands.

Updating to nightly (2.13.0-alpha-*) resolves the issue.

Describe how other contributors can replicate this bug

• Ensure that you have the most recent stable version (2.12.x)
  • Running wp cli update --stable will do the trick
• Run: wp block type list
  • Or any other block command - they're all broken
• Observe that you get an error about 'block' not being a registered wp command

Describe what you would expect as the correct outcome

I expect that the command that is listed in the documentation as existing actually exists

Let us know what environment you are running this on

OS:     Linux 6.12.76-linuxkit #1 SMP Fri Apr 17 14:56:37 UTC 2026 aarch64
Shell:  
PHP binary:     /usr/local/bin/php
PHP version:    8.5.5
php.ini used:   /usr/local/etc/php/php.ini
MySQL binary:   /usr/bin/mariadb
MySQL version:  mariadb from 11.8.6-MariaDB, client 15.2 for debian-linux-gnu (aarch64) using  EditLine wrapper
SQL modes:      
WP-CLI root dir:        phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:      phar://wp-cli.phar/vendor
WP_CLI phar path:       phar:///usr/local/bin/wp
WP-CLI packages dir:    /var/www/.wp-cli/packages/
WP-CLI cache dir:       /var/www/.wp-cli/cache
WP-CLI global config:   /var/www/.wp-cli/config.yml
WP-CLI project config:  
WP-CLI version: 2.12.0

Provide a possible solution

Ensure that the documentation matches the stable version of what it is documenting or otherwise explicitly mark upcoming features as upcoming.

Additionally, ensure that the text of project readmes is accurate. For example, instead of saying, "This package is included with WP-CLI itself, no additional installation necessary." (emphasis added for clarity), the block command's readme should instead say, "This package will be included with WP-CLI itself, until then, additional installation is still necessary.".

Provide additional context/Screenshots

[swissspidy]

wp block is a new addition in the upcoming release. The updated documentation was published a bit prematurely, but since the new release is around the corner, it's not worth removing it again or tweaking any text.

Using WP-CLI nightly is the way to go in the meantime.

[joshualip-plaudit]

@swissspidy Is there a rough ballpark for when the new version will be released? I couldn't find anything on a timeline for it and, frankly, I wouldn't call publishing the docs in mid December "a bit" premature. Is there a place to file issues with the documentation generation process?

(For reference, see: https://web.archive.org/web/20251219031411/https://developer.wordpress.org/cli/commands/)

[swissspidy]

Well we originally aimed for December, that's why. Then with the delay of 7.0 to end of May the earliest we also postponed. Now May looks reasonable for WP-CLI.

Feel free to submit something at https://github.com/wp-cli/handbook.

Again, using the nightly is a good interim solution.