Home » Hooks » display_post_states

The display_post_states hook is a WordPress hook that allows developers to add additional states to a post in the WordPress Admin area. The post states are small labels that appear next to the post title, indicating the status of the post.

This hook is useful when you want to provide your users with more information about the status of a post. For example, you might want to indicate that a post is "Featured" or "New" in the WordPress Admin area.

Here is an example usage code for the display_post_states hook:

add_filter( 'display_post_states', 'custom_post_states' );

function custom_post_states( $states ) {
    $states[] = 'Featured';
    return $states;

In this example, we’re using the add_filter function to hook into the display_post_states hook. We’re then defining a custom function called custom_post_states that takes the existing post states as a parameter.

Inside our custom function, we’re adding a new post state called "Featured" to the existing array of post states. Finally, we’re returning the updated array of post states.

When this code is added to a WordPress theme or plugin, any post that has the "Featured" post meta will now display the "Featured" label next to the post title in the WordPress Admin area.

Learn More on WordPress.org

WordPress snippets using the display_post_states hook

Register an account to save your snippets or go Pro to get more features.