Using WordPress ‘get_post_statuses()’ PHP function

The get_post_statuses() WordPress PHP function retrieves all of the supported post statuses in WordPress.


To use the function, simply call get_post_statuses(). The function returns an array of post statuses.

$post_statuses = get_post_statuses();


  • None

More information

See WordPress Developer Resources: get_post_statuses

This function returns a hard-coded list of statuses. To see the list of all post statuses available in your WordPress instance, including custom statuses, use get_post_stati.


Display all post statuses

This code displays a list of all available post statuses.

$post_statuses = get_post_statuses();
foreach ($post_statuses as $status => $description) {
    echo "Status: {$status}, Description: {$description}\n";

Check if a specific post status exists

This code checks if the ‘draft’ post status is available in WordPress.

$post_statuses = get_post_statuses();
if (array_key_exists('draft', $post_statuses)) {
    echo "Draft status exists!";
} else {
    echo "Draft status not found.";

Count the number of post statuses

This code counts the total number of post statuses available in WordPress.

$post_statuses = get_post_statuses();
$total_statuses = count($post_statuses);
echo "There are {$total_statuses} post statuses available.";

Filter posts by a specific post status

This code retrieves and displays posts with the ‘draft’ post status.

$args = array(
    'post_type' => 'post',
    'post_status' => 'draft',
$query = new WP_Query($args);

if ($query->have_posts()) {
    while ($query->have_posts()) {
        echo "Title: " . get_the_title() . "\n";
} else {
    echo "No draft posts found.";

Get the description of a specific post status

This code retrieves the description of the ‘private’ post status.

$post_statuses = get_post_statuses();
if (array_key_exists('private', $post_statuses)) {
    echo "The private post status description is: {$post_statuses['private']}";
} else {
    echo "Private post status not found.";