Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

The [block] command STILL does not actually exist

Open Beginner friendly
#1,140 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
cli
Domain
cli, documentation

Research direction

Start with the source for the command index and the block documentation page linked in the report, checking how available commands are selected for the live WP-CLI version. Done means the live documentation no longer presents block as an available command, or clearly marks it as alpha/beta, and the commands index agrees.

Written by the indexing model from the issue text.

Description

bug scope:documentation status:unconfirmed

Bug Report

Describe the current, buggy behavior

The block command still enumerated in the online docs despite not being available in the live build of the CLI. I reported this on the 28th of April (see #1002) and was told at the time that the new release was, "around the corner". It has been 4.5 months. The documentation that incorrectly asserts that the block command is available has been live since mid December of 2025 (roughly nine months ago).

Describe how other contributors can replicate this bug

  1. Go to https://developer.wordpress.org/cli/commands/block/
  2. Observe that the page you went to is live
  3. https://developer.wordpress.org/cli/commands/
  4. Observe that it provides a link to that page in the third row of the table enumerating available commands

Describe what you would expect as the correct outcome

I expect the documentation to enumerate the available commands in the currently-live version of the CLI.

Let us know what environment you are running this on

OS:	Linux 4.14.318-241.531.amzn2.x86_64 #1 SMP Tue Jun 27 21:49:00 UTC 2023 x86_64
Shell:	/bin/bash
PHP binary:	/usr/local/bin/php
PHP version:	8.5.6
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 (x86_64) 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:	
WP-CLI cache dir:	/home/joshualip/.wp-cli/cache
WP-CLI global config:	
WP-CLI project config:	
WP-CLI version:	2.12.0

Provide a possible solution

I would recommend that the documentation be updated to not list alpha/beta commands or, if that is not an option, to at least mark the listed alpha/beta commands as available only in the alpha/beta.

Dominant language
Gherkin
Stars
90
Forks
34
Avg merge
3h 19m
Merged PRs (30d)
18

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from wp-cli/wp-cli-bundle

All issues in wp-cli/wp-cli-bundle

Similar issues

More CLI issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.