Title: WP Term Images
Author: John James Jacoby
Published: November 9, 2015
Last modified: October 10, 2026
---
Search plugins
# WP Term Images
By [John James Jacoby](https://profiles.wordpress.org/johnjamesjacoby/)
[Download](https://downloads.wordpress.org/plugin/wp-term-images.2.2.0.zip)
* [Details](https://vec.wordpress.org/plugins/wp-term-images/#description)
* [Reviews](https://vec.wordpress.org/plugins/wp-term-images/#reviews)
* [Installation](https://vec.wordpress.org/plugins/wp-term-images/#installation)
* [Development](https://vec.wordpress.org/plugins/wp-term-images/#developers)
[Support](https://wordpress.org/support/plugin/wp-term-images/)
## 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
* [WP Chosen](https://wordpress.org/plugins/wp-chosen/)
* [WP Pretty Filters](https://wordpress.org/plugins/wp-pretty-filters/)
* [WP Event Calendar](https://wordpress.org/plugins/wp-event-calendar/)
* [WP Media Categories](https://wordpress.org/plugins/wp-media-categories/)
* [WP Term Order](https://wordpress.org/plugins/wp-term-order/)
* [WP Term Authors](https://wordpress.org/plugins/wp-term-authors/)
* [WP Term Colors](https://wordpress.org/plugins/wp-term-colors/)
* [WP Term Icons](https://wordpress.org/plugins/wp-term-icons/)
* [WP Term Visibility](https://wordpress.org/plugins/wp-term-visibility/)
* [WP User Activity](https://wordpress.org/plugins/wp-user-activity/)
* [WP User Avatars](https://wordpress.org/plugins/wp-user-avatars/)
* [WP User Groups](https://wordpress.org/plugins/wp-user-groups/)
* [WP User Profiles](https://wordpress.org/plugins/wp-user-profiles/)
## Screenshots
[⌊Category Images⌉⌊Category Images⌉[
Category Images
[⌊Edit Category Image⌉⌊Edit Category Image⌉[
Edit Category Image
[⌊Choose an Image⌉⌊Choose an Image⌉[
Choose an Image
## 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 ' . ')
';
}
```
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
## Reviews
### [Simple and less intrusive](https://wordpress.org/support/topic/simple-and-less-intrusive/)
[Alvaro Gois dos Santos](https://profiles.wordpress.org/alvarogois/) January 23,
2021
It's simple and less intrusive than other plugins that do the same. It blends better
with WordPress UI. It doesn't show anything in the frontend if the correct code
isn't added to the theme, something like this I guess: term_id; // image id is stored as term meta $image_id = get_term_meta( $taximg_id,'
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( $image ){
echo "
"; } ?>
### [Plugin is out of date, don’t use](https://wordpress.org/support/topic/plugin-is-out-of-date-dont-use/)
[joopon](https://profiles.wordpress.org/joopon/) May 23, 2019
Not compatible with Woocommerce 3.6.3. All taxonomies disappear.
### [Just what I need](https://wordpress.org/support/topic/just-what-i-need-106/)
[Knut Sparhell](https://profiles.wordpress.org/knutsp/) May 1, 2019
Excellent! Works like a charm. Very useful for building nice term pages.
### [Thank you](https://wordpress.org/support/topic/thank-you-1355/)
[dimitris33](https://profiles.wordpress.org/dimitris33/) June 2, 2017
Just tested with the latest version of WP.
### [Best Plugin For Uploading Term Images](https://wordpress.org/support/topic/best-plugin-for-uploading-term-images/)
[Michelle](https://profiles.wordpress.org/michellereefcole/) April 29, 2017
Used this plugin to upload images for each category and child category using get_terms
to display the images in a template.
### [Thanks!](https://wordpress.org/support/topic/thanks-662/)
[wellbeingtips](https://profiles.wordpress.org/wellbeingtips/) January 27, 2017
keep up the good job!
[ Read all 10 reviews ](https://wordpress.org/support/plugin/wp-term-images/reviews/)
## Contributors & Developers
“WP Term Images” is open source software. The following people have contributed
to this plugin.
Contributors
* [ John James Jacoby ](https://profiles.wordpress.org/johnjamesjacoby/)
* [ Stuttter ](https://profiles.wordpress.org/stuttter/)
“WP Term Images” has been translated into 10 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-term-images/contributors)
for their contributions.
[Translate “WP Term Images” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-term-images)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/wp-term-images/), check
out the [SVN repository](https://plugins.svn.wordpress.org/wp-term-images/), or
subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-term-images/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-term-images/?limit=100&mode=stop_on_copy&format=rss).
## 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
## Meta
* Version **2.2.0**
* Last updated **5 days ago**
* Active installations **2.000+**
* WordPress version ** 6.4 or higher **
* Tested up to **7.1.3**
* PHP version ** 7.4 or higher **
* Languages
* [Chinese (Taiwan)](https://tw.wordpress.org/plugins/wp-term-images/), [English (UK)](https://en-gb.wordpress.org/plugins/wp-term-images/),
[English (US)](https://wordpress.org/plugins/wp-term-images/), [German](https://de.wordpress.org/plugins/wp-term-images/),
[Japanese](https://ja.wordpress.org/plugins/wp-term-images/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/wp-term-images/),
[Polish](https://pl.wordpress.org/plugins/wp-term-images/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/wp-term-images/),
[Spanish (Chile)](https://cl.wordpress.org/plugins/wp-term-images/), [Spanish (Spain)](https://es.wordpress.org/plugins/wp-term-images/),
and [Swedish](https://sv.wordpress.org/plugins/wp-term-images/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-term-images)
* Tags
* [image](https://vec.wordpress.org/plugins/tags/image/)[images](https://vec.wordpress.org/plugins/tags/images/)
[metadata](https://vec.wordpress.org/plugins/tags/metadata/)[taxonomy](https://vec.wordpress.org/plugins/tags/taxonomy/)
[term](https://vec.wordpress.org/plugins/tags/term/)
* [Advanced View](https://vec.wordpress.org/plugins/wp-term-images/advanced/)
## Ratings
4.6 out of 5 stars.
* [ 9 5-star reviews ](https://wordpress.org/support/plugin/wp-term-images/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/wp-term-images/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-term-images/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/wp-term-images/reviews/?filter=2)
* [ 1 1-star review ](https://wordpress.org/support/plugin/wp-term-images/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/wp-term-images/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/wp-term-images/reviews/)
## Contributors
* [ John James Jacoby ](https://profiles.wordpress.org/johnjamesjacoby/)
* [ Stuttter ](https://profiles.wordpress.org/stuttter/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/wp-term-images/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](https://ko-fi.com/jjj)