WP Term Images

By John James Jacoby

★ 4.6/5 (10 ratings)2,000+ active installationsVersion 2.2.0

Assign images to categories, tags, and other taxonomy terms with the WordPress media library.

Description

Images for categories, tags, and other taxonomy terms

WP Term Images allows users to assign images to any visible category, tag, or taxonomy term using the media library, providing a customized look for their taxonomies.

Also checkout

Installation

  • Download and install using the built in WordPress plugin installer.
  • Activate in the “Plugins” area of your admin by clicking the “Activate” link.
  • No further setup or configuration is necessary.

FAQ

Does this plugin depend on any others?

No. Not since WordPress 4.4.

Does this create new database tables?

No. There are no new database tables with this plugin.

Does this modify existing database tables?

No. All of WordPress’s core database tables remain untouched.

How do I get the image for a term?

With WordPress’s get_term_meta() function

// image id is stored as term meta
$image_id = get_term_meta( 7, 'image', true );

// image data stored in array, second argument is which image size to retrieve
$image_data = wp_get_attachment_image_src( $image_id, 'full' );

// image url is the first item in the array (aka 0)
$image = $image_data[0];

if ( ! empty( $image ) ) {
    echo '<img src="' . esc_url( $image ) . '" />';
}

The attachment ID is also exposed as the term’s image metadata in the
WordPress REST API. To keep it out of REST responses, return false from the
wp_term_image_show_in_rest filter.

Can I limit the taxonomies that use term images?

Yes. Filter the visible taxonomies after discovery and return only the ones
that should use the image interface:

add_filter( 'wp_term_image_allowed_taxonomies', function( $taxonomies ) {
    return array( 'category', 'post_tag' );
} );

Where can I get support?

  • Basic: https://wordpress.org/support/plugin/wp-term-images/

Where can I find documentation?

https://github.com/stuttter/wp-term-images/wiki

Screenshots

Changelog

[2.2.0] – 2026-09-16

  • Expose image attachment IDs through term metadata in the WordPress REST API
  • Allow sites to restrict the taxonomies that use the term-image interface
  • Add enforceable WordPress and PHP compatibility coding standards

[2.1.3] – 2026-09-16

  • Require WordPress 6.4 or newer

[2.1.2] – 2026-09-14

  • Republish the verified package through corrected WordPress.org distribution automation

[2.1.1] – 2026-09-14

  • Refresh release packaging and distribution metadata

[2.1.0] – 2026-09-13

  • Preserve existing images when programmatic term updates omit the image field
  • Avoid intercepting unrelated term-meta sorting queries
  • Require PHP 7.4 and add automated regression coverage

[2.0.0] – 2019-05-30

  • Update base class

[1.0.0] – 2017-01-16

  • Stability!
  • Fix text domains
  • Simplify some JavaScript
  • Handle more JavaScript edge-cases

[0.3.1] – 2016-07-13

  • Fix regular edits

[0.3.0] – 2016-05-27

  • Fix quick-edits
  • Update WP Term Meta UI dependency to 0.1.9

[0.2.0] – 2016-01-07

  • Fix new-term form action hi-jacking
  • Update WP Term Meta UI dependency to 0.1.4

[0.1.0] – 2015-11-09

  • Initial release