{"id":40060,"date":"2015-11-09T21:51:49","date_gmt":"2015-11-09T21:51:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-term-images\/"},"modified":"2026-10-10T20:14:17","modified_gmt":"2026-10-10T20:14:17","slug":"wp-term-images","status":"publish","type":"plugin","link":"https:\/\/ca.wordpress.org\/plugins\/wp-term-images\/","author":395440,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.2.0","stable_tag":"2.2.0","tested":"7.1.3","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"WP Term Images","header_author":"John James Jacoby","header_description":"","assets_banners_color":"8791e1","last_updated":"2026-10-10 20:14:17","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/ko-fi.com\/jjj","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/wp-term-images\/","header_author_uri":"https:\/\/profiles.wordpress.org\/johnjamesjacoby\/","rating":4.6,"author_block_rating":0,"active_installs":2000,"downloads":56419,"num_ratings":10,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"johnjamesjacoby","date":"2026-03-31 15:50:49","revision":3495785},"2.1.2":{"tag":"2.1.2","author":"johnjamesjacoby","date":"2026-09-14 14:45:17","revision":3695438},"2.1.3":{"tag":"2.1.3","author":"johnjamesjacoby","date":"2026-09-16 07:36:57","revision":3698096},"2.2.0":{"tag":"2.2.0","author":"johnjamesjacoby","date":"2026-10-10 20:14:17","revision":3738653}},"upgrade_notice":[],"ratings":{"1":"1","2":0,"3":0,"4":0,"5":"9"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3738270,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3738270,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3738270,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3738270,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","2.1.2","2.1.3","2.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3738526,"resolution":"1","location":"assets","locale":"","width":1440,"height":1000},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3738526,"resolution":"2","location":"assets","locale":"","width":1440,"height":1000},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3738526,"resolution":"3","location":"assets","locale":"","width":1440,"height":1000}},"screenshots":{"1":"Category Images","2":"Edit Category Image","3":"Choose an Image"}},"plugin_section":[],"plugin_tags":[133,163,2994,91,5058],"plugin_category":[50,57],"plugin_contributors":[77545,78338],"plugin_business_model":[],"class_list":["post-40060","plugin","type-plugin","status-publish","hentry","plugin_tags-image","plugin_tags-images","plugin_tags-metadata","plugin_tags-taxonomy","plugin_tags-term","plugin_category-media","plugin_category-taxonomy","plugin_contributors-johnjamesjacoby","plugin_contributors-stuttter","plugin_committers-johnjamesjacoby"],"banners":{"banner":"https:\/\/ps.w.org\/wp-term-images\/assets\/banner-772x250.png?rev=3738270","banner_2x":"https:\/\/ps.w.org\/wp-term-images\/assets\/banner-1544x500.png?rev=3738270","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/wp-term-images\/assets\/icon-128x128.png?rev=3738270","icon_2x":"https:\/\/ps.w.org\/wp-term-images\/assets\/icon-256x256.png?rev=3738270","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-term-images\/assets\/screenshot-1.jpg?rev=3738526","caption":"Category Images"},{"src":"https:\/\/ps.w.org\/wp-term-images\/assets\/screenshot-2.jpg?rev=3738526","caption":"Edit Category Image"},{"src":"https:\/\/ps.w.org\/wp-term-images\/assets\/screenshot-3.jpg?rev=3738526","caption":"Choose an Image"}],"raw_content":"<!--section=description-->\n<p>Images for categories, tags, and other taxonomy terms<\/p>\n\n<p>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.<\/p>\n\n<h4>Also checkout<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-chosen\/\" title=\"Make long, unwieldy select boxes much more user-friendly.\">WP Chosen<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-pretty-filters\/\" title=\"Makes post filters better match what&apos;s already in Media &amp; Attachments.\">WP Pretty Filters<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-event-calendar\/\" title=\"The best way to manage events in WordPress.\">WP Event Calendar<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-media-categories\/\" title=\"Add categories to media &amp; attachments.\">WP Media Categories<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-term-order\/\" title=\"Sort taxonomy terms, your way.\">WP Term Order<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-term-authors\/\" title=\"Authors for categories, tags, and other taxonomy terms.\">WP Term Authors<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-term-colors\/\" title=\"Pretty colors for categories, tags, and other taxonomy terms.\">WP Term Colors<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-term-icons\/\" title=\"Pretty icons for categories, tags, and other taxonomy terms.\">WP Term Icons<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-term-visibility\/\" title=\"Visibilities for categories, tags, and other taxonomy terms.\">WP Term Visibility<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-user-activity\/\" title=\"The best way to log activity in WordPress.\">WP User Activity<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-user-avatars\/\" title=\"Allow users to upload avatars or choose them from your media library.\">WP User Avatars<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-user-groups\/\" title=\"Group users together with taxonomies &amp; terms.\">WP User Groups<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-user-profiles\/\" title=\"A sophisticated way to edit users in WordPress.\">WP User Profiles<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ul>\n<li>Download and install using the built in WordPress plugin installer.<\/li>\n<li>Activate in the \"Plugins\" area of your admin by clicking the \"Activate\" link.<\/li>\n<li>No further setup or configuration is necessary.<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20depend%20on%20any%20others%3F\"><h3>Does this plugin depend on any others?<\/h3><\/dt>\n<dd><p>No. Not since WordPress 4.4.<\/p><\/dd>\n<dt id=\"does%20this%20create%20new%20database%20tables%3F\"><h3>Does this create new database tables?<\/h3><\/dt>\n<dd><p>No. There are no new database tables with this plugin.<\/p><\/dd>\n<dt id=\"does%20this%20modify%20existing%20database%20tables%3F\"><h3>Does this modify existing database tables?<\/h3><\/dt>\n<dd><p>No. All of WordPress's core database tables remain untouched.<\/p><\/dd>\n<dt id=\"how%20do%20i%20get%20the%20image%20for%20a%20term%3F\"><h3>How do I get the image for a term?<\/h3><\/dt>\n<dd><p>With WordPress's <code>get_term_meta()<\/code> function<\/p>\n\n<pre><code>\/\/ image id is stored as term meta\n$image_id = get_term_meta( 7, 'image', true );\n\n\/\/ image data stored in array, second argument is which image size to retrieve\n$image_data = wp_get_attachment_image_src( $image_id, 'full' );\n\n\/\/ image url is the first item in the array (aka 0)\n$image = $image_data[0];\n\nif ( ! empty( $image ) ) {\n    echo '&lt;img src=\"' . esc_url( $image ) . '\" \/&gt;';\n}\n<\/code><\/pre>\n\n<p>The attachment ID is also exposed as the term's <code>image<\/code> metadata in the\nWordPress REST API. To keep it out of REST responses, return <code>false<\/code> from the\n    wp_term_image_show_in_rest filter.<\/p><\/dd>\n<dt id=\"can%20i%20limit%20the%20taxonomies%20that%20use%20term%20images%3F\"><h3>Can I limit the taxonomies that use term images?<\/h3><\/dt>\n<dd><p>Yes. Filter the visible taxonomies after discovery and return only the ones\nthat should use the image interface:<\/p>\n\n<pre><code>add_filter( 'wp_term_image_allowed_taxonomies', function( $taxonomies ) {\n    return array( 'category', 'post_tag' );\n} );\n<\/code><\/pre><\/dd>\n<dt id=\"where%20can%20i%20get%20support%3F\"><h3>Where can I get support?<\/h3><\/dt>\n<dd><ul>\n<li>Basic: https:\/\/wordpress.org\/support\/plugin\/wp-term-images\/<\/li>\n<\/ul><\/dd>\n<dt id=\"where%20can%20i%20find%20documentation%3F\"><h3>Where can I find documentation?<\/h3><\/dt>\n<dd><p>https:\/\/github.com\/stuttter\/wp-term-images\/wiki<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>[2.2.0] - 2026-09-16<\/h4>\n\n<ul>\n<li>Expose image attachment IDs through term metadata in the WordPress REST API<\/li>\n<li>Allow sites to restrict the taxonomies that use the term-image interface<\/li>\n<li>Add enforceable WordPress and PHP compatibility coding standards<\/li>\n<\/ul>\n\n<h4>[2.1.3] - 2026-09-16<\/h4>\n\n<ul>\n<li>Require WordPress 6.4 or newer<\/li>\n<\/ul>\n\n<h4>[2.1.2] - 2026-09-14<\/h4>\n\n<ul>\n<li>Republish the verified package through corrected WordPress.org distribution automation<\/li>\n<\/ul>\n\n<h4>[2.1.1] - 2026-09-14<\/h4>\n\n<ul>\n<li>Refresh release packaging and distribution metadata<\/li>\n<\/ul>\n\n<h4>[2.1.0] - 2026-09-13<\/h4>\n\n<ul>\n<li>Preserve existing images when programmatic term updates omit the image field<\/li>\n<li>Avoid intercepting unrelated term-meta sorting queries<\/li>\n<li>Require PHP 7.4 and add automated regression coverage<\/li>\n<\/ul>\n\n<h4>[2.0.0] - 2019-05-30<\/h4>\n\n<ul>\n<li>Update base class<\/li>\n<\/ul>\n\n<h4>[1.0.0] - 2017-01-16<\/h4>\n\n<ul>\n<li>Stability!<\/li>\n<li>Fix text domains<\/li>\n<li>Simplify some JavaScript<\/li>\n<li>Handle more JavaScript edge-cases<\/li>\n<\/ul>\n\n<h4>[0.3.1] - 2016-07-13<\/h4>\n\n<ul>\n<li>Fix regular edits<\/li>\n<\/ul>\n\n<h4>[0.3.0] - 2016-05-27<\/h4>\n\n<ul>\n<li>Fix quick-edits<\/li>\n<li>Update WP Term Meta UI dependency to 0.1.9<\/li>\n<\/ul>\n\n<h4>[0.2.0] - 2016-01-07<\/h4>\n\n<ul>\n<li>Fix new-term form action hi-jacking<\/li>\n<li>Update WP Term Meta UI dependency to 0.1.4<\/li>\n<\/ul>\n\n<h4>[0.1.0] - 2015-11-09<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Assign images to categories, tags, and other taxonomy terms with the WordPress media library.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/40060","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=40060"}],"author":[{"embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/johnjamesjacoby"}],"wp:attachment":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=40060"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=40060"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=40060"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=40060"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=40060"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=40060"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}