Categories Images


The Categories Images Plugin allow you to add image with category or taxonomy.

Use <?php if (function_exists('z_taxonomy_image_url')) echo z_taxonomy_image_url(); ?> to get the url and put it in any img tag or simply use <?php if (function_exists('z_taxonomy_image')) z_taxonomy_image(); ?> in (category or taxonomy) template.

Also from settings menu you can exclude any taxonomies from the plugin to avoid conflicting with another plugins like WooCommerce!

More documentation

Go to


  • Image preview and new image field in add/edit category or taxonomy with upload button which allow you to select current or upload a new image.
  • New image field with (upload/remove) buttons to allow you to edit category or taxonomy image in quick edit.
  • When you click the upload button the wordpress upload box will popup, upload or select image then press use this image.
  • New menu (Categories Images) for the plugin settings.
  • Now you can exclude any taxonomy from the plugin and save changes.


You can install Categories Images directly from the WordPress admin panel:

1. Visit the Plugins > Add New and search for 'Categories Images'.
2. Click to install.
3. Once installed, activate and it is functional.


Manual Installation:

1. Download the plugin, then extract it.
2. Upload `categories-images` extracted folder to the `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress

You’re done! The Plugin ready to use, for more please check the plugin description.

More documentation

Go to


Please check the documentation page:


28 July 2023
I had tested them all, and I can confirm that this plugin is the best in its category. I use it throughout my project, the z_taxonomy() function has become my favorite 😉 Thank you, Muhammad, for continuing to maintain it 🙏.
30 November 2021
The plugin saves image link into the Options table. Every saved term will add a row to the site's Options table, which may slow down the site if there are many term images. Also, the option does not get deleted after you remove a term image, it is the option's value that gets cleared out. The option only gets deleted if you delete the term. To me, this looks unprofessional.
17 September 2021
The plugin adds an option from the main menu to a settings page that literally has only one setting and will only be used once. This menu item should be a "Settings" submenu. Having this option in the main menu is unjustified and simply clutters up the menu. Unfortunately for this reason, I chose not to use this plugin and look for alternatives.
23 August 2021 2 replies
Although it works, it requires you to add code to header.php for the Facebook preview to show it: <?php if (function_exists('z_taxonomy_image_url')) echo '<meta property="og:image" content="' . z_taxonomy_image_url() . '" />'; ?> It would be a very nice addition to have the plugin do this for you.
Read all 82 reviews

Contributors and Developers

“Categories Images” is open source software. The following people have contributed to this plugin.


“Categories Images” has been translated into 16 locales. Thank you to the translators for their contributions.

Translate “Categories Images” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change Log


  • Added DE translation, thanks to denarie.
  • Start using imageId instead of imageUrl to solve any the CDN issues, thanks so alessandrocarrera.
  • Tested with the latest version of wordpress


  • Disable options autoload to enhance wordpress queries performace


  • Fix settings page issues
  • Fix compatibility with the latest WordPress version
  • Rewrote the whole plugin from scratch, now the code is much efficient, readable and cleaner


  • Fix compatibility with the latest WordPress version


  • Fix not displaying single tag image bug in tag.php template
  • Adding language support for Swedish. Thanks to Simon Sandgren


  • Fix displaying full size image bug in backend
  • Fix quick edit bug
  • Some code enhancements


  • Adding language support for Russian.
  • Adding language support for Serbian. Thanks to Andrijana Nikolic [].
  • Adding language support for Catalan. Thanks to Marc Queralt i Bassa [].
  • Change the plugin text domain from zci to categories-images to match the plugin slug as requested by WordPress.


  • Adding language support for Ukrainian. Thanks to Michael Yunat [].
  • Adding new function z_taxonomy_image() to display category or taxonomy image directly with support for size, alt and other attributes, for and how to use it please check the documentations.
  • Some code enhancements.


  • Update code to reduce db queries. Thanks to fburatti [].


  • Fix placeholder bug in backend.


  • Adding language support for Spanish (Thansk so much to Maria Ramos []).
  • Adding support for resizing categories images (Thanks so much to Rahil Wazir).
  • Some code enhancements.


  • Adding language support for French.


  • Bug fix in js for WordPress media uploader.


  • New screenshots.
  • Updated language file.
  • Added support for both old and new WordPress media uploader.
  • Added new submenu (Categories Images) in Settings menu.
  • Added new settings for excluding any taxonomies from the plugin.
  • Added new placeholder image.

Thanks to Patrick and Hassan for the new ideas.


  • java script bug fixed, reported about conflicting with WooCommerce plugin. Thanks to Marty McGee.


  • bug fix in displaying category or taxonomy image at the frontend.


  • bug fix in displaying placeholder image in wp-admin.


  • edit z_taxonomy_image_url() to only return data in case the user inserted image for the selected category or taxonomy


  • fix a bug, prevent a function from running execpt when editing a category or taxonomy to avoid affecting other wordpress edit pages in the wp-admin


  • fix a bug in languages
  • fix a bug in quick edit category or taxonomy


  • New screenshots.
  • Added l10n support.
  • Added Arabic and Chinese languages.
  • Added new button for upload or select an image using wordpress media uploader.
  • Added default image placeholder.
  • Added thumbnail in categories or taxonomies list.
  • Added image thumbnail, image text box, upload button and remove button in quick edit.
    Thank so much to Joe Tse 🙂


Adding some screenshots


Fix javascript bug with wordpress 3.4


The First Release