apply_filters( 'manage_posts_columns', string[] $post_columns , string $post_type )
Filters the columns displayed in the Posts list table.
Contents
Parameters
- $post_columns
-
(string[]) An associative array of column headings.
- $post_type
-
(string) The post type slug.
More Information
manage_posts_columnsis a filter applied to the columns shown on the manage posts screen. It’s applied to posts of all types except pages. To add a custom column for pages, hook the manage_pages_columns filter. To add a custom column for specific custom post types, hook the manage_{$post_type}_posts_columns filter.- Built-in Column Types
Listed in order of appearance. By default, all columns supported by the post type are shown.- cb Checkbox for bulk actions.
- title Post title. Includes “edit”, “quick edit”, “trash” and “view” links. If $mode (set from $_REQUEST[‘mode’]) is ‘excerpt’, a post excerpt is included between the title and links.
- author Post author.
- categories Categories the post belongs to.
- tags Tags for the post.
- comments Number of pending comments.
- date The date and publish status of the post.
Source
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
To add a custom column, hook into this filter, and add an item to the
$post_columnsarray. The key should be a string ID, and the value should be the human-readable text to display in the column’s header.<?php namespace DemoPlugin; const COLUMN_ID = 'publisher'; /** * Register the custom column. * * @param array $columns Existing columns. * @return array Columns with custom column added. */ function register_column( array $columns ) : array { $columns[ COLUMN_ID ] = __( 'Publisher', 'demo-plugin' ); return $columns; } add_action( 'manage_posts_columns', __NAMESPACE__ . '\\register_column' ); // You will likely also want to hook into 'manage_posts_custom_column' to // output the column's value. function render_column( string $column_id ) { if ( $column_id !== COLUMN_ID ) { return; } $post = get_post(); echo esc_html( get_post_meta( $post->ID, '_demo_publisher', true ) ); } add_action( 'manage_posts_custom_column', __NAMESPACE__ . '\\render_column' );Expand full source codeCollapse full source code
If the new custom column is only for the default post type, then it needs to check the post type.
function my_add_new_columns($columns) { $post_type = get_post_type(); if ( $post_type == 'post' ) { $new_columns = array( 'my_featured' => esc_html__( 'Featured', 'text_domain' ), ); return array_merge($columns, $new_columns); } } add_filter( 'manage_posts_columns', 'my_add_new_columns' );Top ↑
Feedback
Note: If you are using “@Keramot UL Islam” solution, make sure to return a default $columns otherwise it will mess up other post type’s columns. I.E.
function wpdocs_my_add_new_columns( $columns ) { $post_type = get_post_type(); if ( 'post' === $post_type ) { $new_columns = array( 'my_featured' =&gt; esc_html__( 'Featured', 'text_domain' ), ); return array_merge( $columns, $new_columns ); } // must return default $column value return $columns; } add_filter( 'manage_posts_columns', 'wpdocs_my_add_new_columns' );— By merlinthewarlock —
Example: To add custom featured image thumbnail column in the post.
function wpdocs_posts_thumb_columns( $columns ) { $post_new_columns = array( 'post_thumbs' => esc_html__( 'Thumbs', 'text_domain' ), ); return array_merge( $columns, $post_new_columns ); } add_filter( 'manage_posts_columns', 'wpdocs_posts_thumb_columns', 5 ); function wpdocs_posts_custom_columns( $column_name, $id ) { if ( 'post_thumbs' === $column_name ) { the_post_thumbnail( 'thumbnail' ); } } add_action( 'manage_posts_custom_column', 'wpdocs_posts_custom_columns', 5, 2 );Expand full source codeCollapse full source code
Example migrated from Codex:
To add a column showing whether a post is sticky or not:
function add_sticky_column( $columns ) { $columns['sticky'] = __('Sticky'); return $columns; } add_filter( 'manage_posts_columns' , 'add_sticky_column' );To actually display whether or not a post is sticky, hook the manage_posts_custom_column action.
Example: This will remove the author, categories, tags and comment columns from backend Posts > All Posts section.
if ( ! function_exists( 'custom_manage_posts_column' ) ) { function custom_manage_posts_column( $columns ) { unset( $columns['author'] ); unset( $columns['categories'] ); unset( $columns['tags'] ); unset( $columns['comments'] ); return $columns; } } if ( has_filter( 'manage_posts_columns' ) ) { add_filter( 'manage_posts_columns', 'custom_manage_posts_column' ); }