Add Custom Column to Taxonomies Table in Wordpress

WordPress shows default fields Name, Description, Slug and Posts count in taxonomies admin table. Learn in this post how to show custom column in WordPress taxonomies table.

You will need to utilize filter and action hooks of WordPress if you have a term meta saved with taxonomy term and want to display it in taxonomy table. In this post we are going to show you how to customize taxonomy table columns in WordPress and show additional column in taxonomies table. 

We have a term meta "Price" which we saved in one of our posts Add Taxonomy Term Meta in WordPress for our "Property City" taxonomy. In this post we will show term meta in a table column of taxonomies.

 

WordPress Hooks to Manage Taxonomies Table Columns

add_filter('manage_edit-{$taxonomy}_columns', string[] $columns);
do_action('manage_{$taxonomy}_custom_column', string $content, string $column_name, int $term_id);

The "manage_edit-{$taxonomy}_columns" is for adding a new column to table columns array while "manage_{$taxonomy}_custom_column" is for displaying the content of that new column and $taxonomy is the slug of taxonomy you want add a column for.

 

add_filter("manage_edit-{$taxonomy}_columns", string[] $columns);

• $columns: (array)  - Associate array of columns heading strings.

 

do_action("manage_{$taxonomy}_custom_column", string $content, string $column_name, int $term_id);

• $content: (string): The content as string of column.
  
• $column_name: (string)  - The name of the column for which we are adding the content.
• $term_id: (int): The id of current taxonomy term.

 

Add Column to WordPress Taxonomies Table

We will create taxonomy-columns.php file and include it in functions.php. Steps to add column to WP taxonomies table:

• Register a filter hook manage_edit-{$taxonomy}_columns for column heading.
• Add a column to $columns array.
• Sort columns array to change position of column in table.
• Register an action hook manage_{$taxonomy}_custom_column to display the content of each column.
• Add a switch statement to check column and add content accordingly.
  

taxonomy-columns.php

<?php
// Filter hook to add zipcode column
add_filter('manage_edit-property-city_columns', 'register_property_city_columns' );
function register_property_city_columns($columns): array
{
    $sorted_columns = [];
    // Get array of column keys for sorting, You can prepare a static array of columns if columns are already known
    $column_keys = array_keys($columns);


    // Add price column to second last position in columns
    array_splice($column_keys, count($column_keys) - 1, 0, ['zipcode']);

    // Add both columns to original columns at the end
    $columns['zipcode'] = __('Zipcode', 'wp-manor');

    // Loop through keys and prepare new sorted array of columns
    foreach($column_keys as $column_key){
        $sorted_columns[$column_key] = $columns[$column_key];
    }

    return $sorted_columns;
}

// Action hook to display zipcode content or value
add_action('manage_property-city_custom_column', 'add_property_city_columns_content', 10, 3);
function add_property_city_columns_content($string, $columns, $term_id)
{
    switch ($columns) {
        case 'zipcode':
            echo esc_html(get_term_meta($term_id, 'zipcode', true));
            break;
    }
}

Now we will include this taxonomy-columns.php in our functions.php to work.

include('taxonomy-columns.php');

This is how the property cities list table will look like:

This new column will also show in screen options like this: