Example plugin for adding an image upload field to taxonomy terms in WordPress
Switch branches/tags
Nothing to show
Clone or download
Latest commit e66985e Jul 5, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
js fixing issue #5, case when image is smaller than thumbnail size Oct 21, 2015
README.md minor readme updates Jan 7, 2016
taxonomy-term-image.php version increment Jul 5, 2016


Taxonomy Term Image

An example plugin for adding an image upload field to taxonomy term edit pages, and an example of the new taxonomy term meta data added in WordPress 4.4. This example IS NOT compatible with any version of WordPress lower than 4.4, it is meant to be used as an example only.

How to use within a theme or plugin:

Setup file:

  1. Delete plugin meta data at the top of taxonomy-term-image.php
  2. include_once taxonomy-term-image.php


filter taxonomy-term-image-taxonomy:

Change the taxonomy targeted by the plugin. By default, the category taxonomy is the only taxonomy targeted. You can change this to tags if you'd like following the example below:

	function the_term_image_taxonomy( $taxonomy ) {
		// use for tags instead of categories
		return 'post_tag';
	add_filter( 'taxonomy-term-image-taxonomy', 'the_term_image_taxonomy' );

Alternatively, the plugin can target more than one taxonomy by providing it an array of taxonomy slugs:

	function the_term_image_taxonomy( $taxonomy ) {
		// use for tags and categories
		return array( 'post_tag', 'category' );
	add_filter( 'taxonomy-term-image-taxonomy', 'the_term_image_taxonomy' );

filter taxonomy-term-image-labels:

Change the field and button text.

	function the_taxonomy_term_image_labels( $labels ) {
		$labels['fieldTitle'] = __( 'My Super Rad Plugin', 'yourdomain' );
		$labels['fieldDescription'] = __( 'This plugin is cool, and does neat stuff.', 'yourdomain' );

		return $labels;
	add_filter( 'taxonomy-term-image-labels', 'the_taxonomy_term_image_labels' );

filter taxonomy-term-image-meta-key:

Change the meta key used to save the image ID in the term meta data

	function the_taxonomy_term_image_meta_key( $option_name ) {
		// store in term meta where term meta key is = 'my_term_meta_key'
		return 'my_term_meta_key';
	add_filter( 'taxonomy-term-image-meta-key', 'the_taxonomy_term_image_meta_key' );

filter taxonomy-term-image-js-dir-url:

Change where the js file is located. (no trailing slash)

	function my_taxonomy_term_image_js_dir_url( $option_name ) {
		// change the js directory to a subdirectory of this hook
		return plugin_dir_url( __FILE__ ) . '/js';
	add_filter( 'taxonomy-term-image-js-dir-url', 'my_taxonomy_term_image_js_dir_url' );

show image on archive template

Term Image IDs are automatically attached to terms that are passed through the get_term and get_terms filters as the ->term_image property.

	$term = get_term( 123, 'category' );

	if ( $term->term_image ) {
		echo wp_get_attachment_image( $term->term_image, 'full' );

In order to retrieve the term image on an archive page:

	$term = get_queried_object();

	if ( $term->term_image ) {
	    echo wp_get_attachment_image( $term->term_image, 'full' );



Code References: