I've done this previously but I've forgotten the name of the hook, and can't find it anywhere...

What I'm trying to do is add some custom columns in the listing of a custom post type in the admin.

For example, in the admin, click on articles, I want to add custom column there.


The hooks to create custom columns and their associated data for a custom post type are manage_{$post_type}_posts_columns and manage_{$post_type}_posts_custom_column respectively, where {$post_type} is the name of the custom post type.

This example from the documentation removes the author column and adds a taxonomy and meta data column:

// Add the custom columns to the book post type:
add_filter( 'manage_book_posts_columns', 'set_custom_edit_book_columns' );
function set_custom_edit_book_columns($columns) {
    unset( $columns['author'] );
    $columns['book_author'] = __( 'Author', 'your_text_domain' );
    $columns['publisher'] = __( 'Publisher', 'your_text_domain' );

    return $columns;

// Add the data to the custom columns for the book post type:
add_action( 'manage_book_posts_custom_column' , 'custom_book_column', 10, 2 );
function custom_book_column( $column, $post_id ) {
    switch ( $column ) {

        case 'book_author' :
            $terms = get_the_term_list( $post_id , 'book_author' , '' , ',' , '' );
            if ( is_string( $terms ) )
                echo $terms;
                _e( 'Unable to get author(s)', 'your_text_domain' );

        case 'publisher' :
            echo get_post_meta( $post_id , 'publisher' , true ); 

  • 1
    Thank you for this hook!!! This is brilliant!! There's no clear documentation on stackoverflow!!! :D Cheers mate May 30 '19 at 2:12
  • isn't there any option to set the column number? like column_index[2]. Because the custom_column appears at the end of the column. Jun 21 '19 at 8:52
  • 1
    @DilipGupta $columns is an array, you can reorder before you return it
    – fogx
    Jul 16 '19 at 10:39
  • 1
    In the case of adding a taxonomy term column. How would you add a link below the term name that would Filter the table to that term? I have seen this on a few plugins before.
    – iamonstage
    Mar 14 '21 at 15:01
  • @iamonstage register_taxonomy() now has support for that built in via the show_admin_column setting passed via arguments. developer.wordpress.org/reference/functions/register_taxonomy. If you aren't registering the taxonomy yourself, you can still alter the args via the register_taxonomy_args filter developer.wordpress.org/reference/hooks/register_taxonomy_args Mar 15 '21 at 6:05

I wrote a function that combines manage_{$post_type}_posts_columns filter and manage_{$post_type}_posts_custom_column action.

function add_admin_column($column_title, $post_type, $cb){

    // Column Header
    add_filter( 'manage_' . $post_type . '_posts_columns', function($columns) use ($column_title) {
        $columns[ sanitize_title($column_title) ] = $column_title;
        return $columns;
    } );

    // Column Content
    add_action( 'manage_' . $post_type . '_posts_custom_column' , function( $column, $post_id ) use ($column_title, $cb) {

        if(sanitize_title($column_title) === $column){

    }, 10, 2 );


add_admin_column(__('EAN'), 'product', function($post_id){
    echo get_post_meta( $post_id , 'ean' , true ); 

I'm not sure if it default custom meta data that you want to show as columns, but you could consider to use this free plugin that allows you to add columns to display custom fields. https://wordpress.org/plugins/codepress-admin-columns/

The pro version even allows you to add filtering, sorting and inline edit to those columns.

  • DO NOT USE! Will break your site: PHP Fatal error: Cannot redeclare AC() (previously declared in [redacted]\\wp-content\\themes\[redacted]\\functions.php:628) in [redacted]\\wp-content\\plugins\\codepress-admin-columns\\api.php on line 9 Nov 6 '18 at 20:17
  • @PeterKionga-Kamau this is a compatibility-issue with your specific theme. The error you posted will not appear with a default WP theme (such as twentytwenty); I also use the plugin with the Divi Theme and find it quite useful
    – Philipp
    Oct 8 '19 at 19:34
  • Isn't there some kind of namespacing or use of less generic function names that could be used to avoid this? Oct 9 '19 at 20:06

Based on Carlos response (thank you very much) I wanted to add a little thumbnail image, but not a featured one, one from custom metabox.

So this is what I added:

add_admin_column(__('Thumbnail'), 'obraz', function($post_id){
$image_id =  get_post_meta( $post_id , 'custom_thumbnail_metabox' , true );
echo '<img src="'.wp_get_attachment_image_url($image_id).'" />';

Info: the post meta will get the ID of the attachment/image so thats the reason for later call of wp_get_attachment_image_url


For woocommerce orders I needed to use the filter: manage_edit-shop_order_columns.

add_filter( 'manage_edit-shop_order_columns', 'manage_shop_order_posts_columns', 10, 1 );
manage_shop_order_posts_columns($columns) {
    $columns['test'] = 'Test';
    return $columns;

Then to populate the field:

add_action( 'manage_shop_order_posts_custom_column' , 'manage_shop_order_custom_column', 10, 2 );
function manage_shop_order_custom_column($column, $post_id) {
    switch ( $column )
        case 'test' :
            echo '1234';

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.