Taxonomy Images Wordpress Plugin is used by 544 websites. Among 544, 1 site is within top 10,000 and 34 sites are within top 100,000 websites.

Wordpress Plugin Information of

Plugin Meta Name Plugin Meta Information
Plugin Name
Plugin Description Associate images from your media library to categories, tags and custom taxonomies.
Detail Plugin Description

For usage instructions please view the screencast.

Displaying Your Images in Your Theme

There are a few filters that you can use in your theme to display the image associations created by this plugin. Please read below for detailed information.

Display a single image representing the term archive

The following filter will display the image associated with the term asked for in the query string of the url. This filter only works in views that naturally use templates like category.php, tag.php taxonomy.php and all of their derivatives. Please read about template hierarchy for more information about these templates. The simplest use of this filter looks like:

print apply_filters( 'taxonomy-images-queried-term-image', '' );

This code will generate and print an image tag. It's output can be modifed by passig an optional third parameter to apply filters. This parameter is an array and the following keys may be set:

  • after (string) - Text to append to the image's HTML.

  • attr (array) - Key/value pairs representing the attributes of the img tag. Available options include: alt, class, src and title. This array will be passed as the fourth parameter to WordPress core function wp_get_attachment_image() without modification.

  • before (string) - Text to prepend to the image's HTML.

  • image_size (string) - May be any image size registered with WordPress. If no image size is specified, 'thumbnail' will be used as a default value. In the event that an unregistered size is specified, this filter will return an empty string.

Here's an example of what a fully customized version of this filter might look like:

print apply_filters( 'taxonomy-images-queried-term-image', '', array(
    'after' => '</div>'
    'attr' => array(
        'alt'   => 'Custom alternative text',
        'class' => 'my-class-list bunnies turtles',
        'src'   => 'this-is-where-the-image-lives.png',
        'title' => 'Custom Title',
    'before' => '<div id="my-custom-div">',
    'image_size' => 'medium',
    ) );

Similar functionality

If you just need to get the database ID for the image, you may want to use:

$image_id = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );

If you need to get the full object of the image, you may want to use:

$image = apply_filters( 'taxonomy-images-queried-term-image-object', '' );

If you need to get the url to the image, you may want to use the following:

$image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '' );

You can specify the size of the image in an option third parameter:

$image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '', array(
    'image_size' => 'medium'
    ) );

If you need data about the image, you may want to use:

$image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '' );

You can specify the size of the image in an option third parameter:

$image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '', array(
    'image_size' => 'medium'
    ) );

List term images associated with a post object

When a post is being displayed you may want to display all of the images associated with all of the terms that are associated with the post (a mouthful? Yes indeed!). The taxonomy-images-list-the-terms filter does this. Here's what it looks like in its simplest form:

print apply_filters( 'taxonomy-images-list-the-terms', '' );

This filter accepts an optional third parameter that you can use to customize its output. It is an array which recognizes the following keys:

  • after (string) - Text to append to the output. Default value is a closing unordered list element.

  • after_image (string) - Text to append to each image. Default value is a closing list-item element.

  • before (string) - Text to prepend to the output. Default value is an open unordered list element with an class attribute of "taxonomy-images-the-terms".

  • before_image (string) - Text to prepend to each image. Default value is an open list-item element.

  • image_size (string) - Any registered image size. Values will vary from installation to installation. Image sizes defined in core include: "thumbnail", "medium" and "large". "Fullsize" may also be used to get the unmodified image that was uploaded. Defaults to "thumbnail".

  • post_id (int) - The post to retrieve terms from. Defaults to the ID property of the global $post object.

  • taxonomy (string) - Name of a registered taxonomy to return terms from. Defaults to "category".

Here's an example of what a fully customized version of this filter might look like:

print apply_filters( 'taxonomy-images-list-the-terms', '', array(
    'after'        => '</div>',
    'after_image'  => '</span>',
    'before'       => '<div class="my-custom-class-name">',
    'before_image' => '<span>',
    'image_size'   => 'detail',
    'post_id'      => 1234,
    'taxonomy'     => 'post_tag',
    ) );

Working with all terms of a given taxonomy

You will want to use the 'taxonomy-images-get-terms' filter. This filter is basically a wrapper for WordPress core function get_terms(). It will return an array of enhanced term objects: each term object will have a custom property named image_id which is an integer representing the database ID of the image associated with the term. This filter can be used to create custom lists of terms. Here's what it's default useage looks like:

$terms = apply_filters( 'taxonomy-images-get-terms', '' );

Here is what php's print_r() function may return:

    [0] => stdClass Object
            [term_id] => 8
            [name] => Pirate
            [slug] => pirate
            [term_group] => 0
            [term_taxonomy_id] => 8
            [taxonomy] => category
            [description] => Pirates live in the ocean and ride around on boats.
            [parent] => 0
            [count] => 1
            [image_id] => 44

As you can see, all of the goodness of get_terms() is there with an added bonus: the image_id parameter!

This filter recognizes an optional third parameter which is an array of arguments that can be used to modify its output:

  • cache_images (bool) If this value is true all assocaite images will be queried for and cached for later use in various template tags. If it is set to false, this query will be suppressed. Do not set this value to false unless you have a really good reason for doing so :) Default value is true.

  • having_images (bool) If this value is true then only terms that have associated images will be returned. Setting it to false will return all terms. Default value is true.

  • taxonomy (string) Name of a registered taxonomy to return terms from. Multiple taxonomies may be specified by separating each name by a comma. Defaults to "category".

  • term_args (array) Arguments to pass to get_terms() as the second parameter. Default value is an empty array.

Here's and example of a simple custom loop that you can make to display all term images:

$terms = apply_filters( 'taxonomy-images-get-terms', '' );
if ( ! empty( $terms ) ) {
    print '<ul>';
    foreach( (array) $terms as $term ) {
        print '<li><a href="' . esc_url( get_term_link( $term, $term->taxonomy ) ) . '">' . wp_get_attachment_image( $term->image_id, 'detail' ) . '</li>';
    print '</ul>';


If you have questions about integrating this plugin into your site, please add a new thread to the WordPress Support Forum. I try to answer these, but I may not always be able to. In the event that I cannot there may be someone else who can help.

Bugs, Suggestions

Development of this plugin is hosted in a public repository on Github. If you find a bug in this plugin or have a suggestion to make it better, please create a new issue

Hook it up yo!

If you have fallen in love with this plugin and would not be able to sleep without helping out in some way, please see the following list of ways that you can hook it up!:

  • Rate it! - Use the star tool on the right-hand sidebar of the homepage.

  • Let me know if it works - Use the Compatibility widget on the homepage to let everyone know that the current version works with your version of WordPress.

  • Do you Twitter? Help promote by using this shortlink:

  • Are you a writer? Help promote by writing an article on your website about this plugin.

  • Are you Super-Wicked-Awesome? If so, you can always make a donation.

Need More Taxonomy Plugins?

I've released a handfull of plugins dealing with taxonomies. Please see my plugin page for more info.

More Information Wordpress Official Plugin Repository

Top 100 Websites built with Wordpress plugin

VentureBeat | Tech News That Matters
Digital India, Internet, Mobile News - MediaNama
Mercedes-Benz - International Corporate Website
The Poke | Time well wasted
Go Fug Yourself: Because Fugly Is The New Pretty
Boston Magazine
23,530 favicon of HYPABLE.COM HYPABLE.COM
Hypable • Breaking entertainment news, photos, videos, and more
UrbanPost - News
Heavy Metal News, Music Videos, Tour Dates - Metal Injection
DireDonna | Magazine femminile
Mercato foot - But! Football Club
Mutua Madrid Open
Leite's Culinaria | Recipes, Food, and Cooking Blog
سعودي شفت | أخبار السيارات
Boulevard Voltaire - La liberté guide nos pas
Analítica: Noticias de Venezuela y el Mundo -
Mobile and web casual games: improving players' experience
Green Wedding Shoes Wedding Blog | Wedding Trends for Stylish + Creative Brides | Southern California Wedding Inspirations for the Modern Bride
Android en español | Androidsis
57,596 favicon of 1001EDA.COM 1001EDA.COM
1001 Еда: простые рецепты с фото, рецепты салатов, готовим быстро и просто вкусные блюда на завтрак, обед и ужин
Bridal Musings Wedding Blog - A chic and creative wedding blog
63,565 favicon of POPDUST.COM POPDUST.COM
Popdust - Because Pop Culture Matters
64,954 favicon of TRAVAUX.COM TRAVAUX.COM
Devis, construire, rénover, aménager et décorer une maison, un appartement ou un bureau |
Não mesmo - NO.
70,922 favicon of FUELFIX.COM FUELFIX.COM
Fuel Fix - Houston's daily must-read source for news and analysis on the oil, gas and energy business
Marketing de Conteúdo | Blog de Marketing Digital
71,380 favicon of CAGLE.COM CAGLE.COM
The Cagle Post
The American Interest - The American Interest
Maximise your profit
Jack Canfield | Success Principles for Peak Performance
95,905 favicon of ABCHOME.COM ABCHOME.COM
ABC Carpet & Home: Inspired Design, Modern Furniture, Rugs & Gifts
Giving you true notes since 247,000 BC | Okayafrica. Okayafrica.
Woodworking |Videos | Plans | How To | America's Leading Woodworking Authority
Spicy Southern Kitchen - Tasty food and drink recipes straight from the South, y'all!
DialogTech - Calls Drive Revenue. DialogTech Drives Calls.
Food Photography, Recipes, Los Angeles Food Photographers
106,611 favicon of GNAMGNAM.IT GNAMGNAM.IT
Ricette di cucina di GnamGnam - Ricette con foto passo passo
107,366 favicon of TIDYMOM.NET TIDYMOM.NET
TidyMom | Find easy recipes, household tips and products that inspire women to embrace their inner-homemaker, ease the chaos of everyday life and create a functional, fun and tidy home.
Content Sparks - Fire Up Your Business With Professional Quality Content
Accelerate Sales Training | WAGmob
The New Inquiry
Rick Bayless | Frontera Restaurants and Recipes
Ramoji Film City «
127,482 favicon of WOMEN2.COM WOMEN2.COM
Women 2.0
Le site de la Sneaker - Toute l'actu sneakers au quotidien.
Downloads for Bankers and Consultants -
Seriale Online | Oglądaj seriale online za darmo na!
Solar Power News, Solar Power Design, Solar Inverters, Photovoltaics
Усыновить ребенка из детского дома и дома малютки. | Измени одну жизнь. Помощь детям-сиротам.
Mobile Apps | Salesforce | Software Product Development | Algoworks
Already Pretty | Where style meets body image
Crafts by Amanda - easy craft tutorials for kids and adults
162,088 favicon of GANNIKUS.COM GANNIKUS.COM
Home - | Supplement Deals. Reviews. Lifestyle.
Recetas Thermomix
166,422 favicon of NOOBCOOK.COM NOOBCOOK.COM
Noob Cook Recipes - Singapore food and cooking blog
166,732 favicon of NEUFMOIS.FR NEUFMOIS.FR
Grossesse, Enceinte, Conception, Fertilité, Maternités, Poussettes
Torchy's Tacos - Damn Good Tacos
Content Marketing Agency in San Diego - Siege Media
Bakers Royale
Freeskier Magazine - Skiing videos, news, gear reviews and more
Dorset Cereals - honest, tasty & real unadulterated breakfast pleasure, muesli, porridge and cereal
186,874 favicon of ELITE.COM ELITE.COM
Elite | Providing a Global Enterprise Business Management Solution | Enterprise Relationship Management, Law Firm Business Development Software, Law Firm Experience Management Software, Law Firm Marketing Software, Legal Case Management Software, Law Practice Management Software, Legal Matter Management Software, Legal Document Management System, Docketing Software, Legal Calendar Software, Law Firm Accounting Software, Law Firm Financial Management, Legal Billing Software, Law Firm Management Software, Attorney Software, Law Firm Software, Law Office Management Software, Law Firm Risk Management, Conflicts Management Software, Law Firm Business Intelligence, Legal Records Management, Legal CRM Software, Enterprise Business Management Solution, Client and Matter Management, Law Firm Accounting and Billing, Law Firm Mobile Software
Deliciously Sprinkled | Deliciously Sprinkled
Onward Search - staffing for digital marketing and creative jobs
Noticias sobre coches y motor | Actualidad Motor
Fifteen Spatulas
Dear Crissy | Lifestyle + Family by Crissy Page
Bloques AutoCAD Gratis de Arquitectura (extensión CAD blocks .dwg)
200,719 favicon of 10AND5.COM 10AND5.COM
Between 10 and 5 - The South African creative showcase
202,102 favicon of UNIMARC.CL UNIMARC.CL
Adrenalina10 - Surf, Skate e Esportes Radicais
Luxury Flats, Top Builders in Bangalore | Asset Builders
Design Engineering News, Engineering Videos, Engineering Resources
209,136 favicon of ANIMAL.CO.UK ANIMAL.CO.UK
Animal | Surf, Skate, Bike, Snow. UK action sports lifestyle brand
SardegnaLavoro - Home page
Chiang Mai Citylife - Life in Chiang Mai, Thailand
DataFactory | The Real Time Sport Statistics Leader in Latin America
Live Share Travel: Luxury for less luxury travel blog & magazine
temp-tations® by Tara - Bakeware sets, cookware, ovenware and dinnerware. Carved Old World
218,834 favicon of NOTIFE.COM NOTIFE.COM
Notife - Diario Digital de Santa Fe
news assurances | N°1 de l'aide aux assurés
Corso di Ottimizzazione del Computer - Impara ad ottimizzare il tuo computer - Lezioni gratuite e facili per tutti
228,853 favicon of YODRAMA.COM YODRAMA.COM
Yodrama - Watch Streaming Korean drama, Japanese drama online Free-English Subbed
Gluten-Free Living
SEO et création de site web au Maroc
Amanda's Cookin' - family friendly recipes and sweet desserts
Free Healthy Vegetarian and Vegan Recipes - Raw Food Recipes – Free Healthy Vegetarian and Vegan Recipes
242,849 favicon of UMPHREYS.COM UMPHREYS.COM
243,033 favicon of WYDAILY.COM WYDAILY.COM
Williamsburg Yorktown Daily | You can do without the paper; you can't do without the news.
Tasty Bite
244,071 favicon of CUMULUS.COM CUMULUS.COM
Cumulus Media
Mommy Hates Cooking - A young mom with a hatred for cooking tackles the daily grind and the oven.
249,560 favicon of GEORGIA.ORG GEORGIA.ORG
Home - Georgia Department of Economic Development
Heather Christo - Eat Well, Live Free. Deliciously Allergy Free Recipes. | Парники и теплицы строим сами - Your Daily Best Inspiring Visual