The Events Calendar Category Colors


Add background colors to event categories displayed in the event views of The Events Calendar. This is inspired by the post Coloring Your Category Events.

Settings for The Events Calendar Category Colors plugin are located in their own tab on The Events Calendar Settings page.

To force a refresh of your CSS, add ?refresh_css to the end of your events URL.


Thanks to jonahcoyote for some early help and direction.

Big thanks to Barry Hughes (WebsiteBakery) for refactoring code and Legend Superpowers.

Translations courtesy of:


  • The Events Calendar Category Colors Settings tab
  • The Events Calendar Category Colors in action
  • The Events Calendar Category Colors with Legend Superpowers in action


Does the plugin require The Events Calendar plugin?

Yes. The Events Calendar plugin is written by Modern Tribe, Inc. It requires at least The Events Calendar v3.0.

What if I use a version of The Events Calendar 2.x?

The last compatible version of this plugin that works with TEC 2.x is The Events Calendar Category Colors v1.6.3.

Where can I get more help?

There is more extensive documentation of the plugins features and usage on the The Events Calendar Category Colors wiki.

Where can I report bugs?
  1. Add a new topic on the WordPress Support Forum.
  2. Add a new issue on the github repo.


A Refreshing Plugin

TEC does not include the ability to color event categories. The Events Calendar Category Colors add-on to the rescue! The plugin works as advertised and is a must-have for TEC users. Good support too.

I gave 4 instead of 5 stars so Andy would have something to work toward 😉 It would be nice to support standard color names (instead of Hex only) and provide some preset styles to category legends….and then charge for the add-on/plugin.

Well Done; Exactly What Was Needed!

I needed a straightforward way to color-code categories, and was directed to this plugin. After installation, there was a slight hiccup in how the colors displayed in the list view (specific to the theme I’m using). I found a similar thread in the forums, posted a note there, and I was pleasantly surprised to hear so quickly from Andy, and that he had a solution.

Although I’m not a coder, I CAN copy/paste into the right place in the child theme functions.php file. 🙂 Andy hunted down this specific issue with the theme/merged stylesheet, and gave me code to solve it!

It’s really impressive to get such a quick response and a custom fix from a Developer.


Refuse de fonctionner dans certaines condition ?

Refuse de fonctionner, testĂ© diffĂ©rents rĂ©glages mais rien n’y fait ce plug ne veut pas fonctionner dans mon cas (server local),

Peut-ĂȘtre un problĂšme de rafraĂźchissement JS
Tout rĂ©-installĂ© ce matin et c’est OK

Nifty addition to The Events Calendar & Great Support

5 stars for this little gem of a plugin, which I will definitely consider using again.
– great documentation
– the developers have gone out of their way to make this customizable via theme overrides
– very responsive and helpful support

Thanks for sharing and supporting your awesome plugin!

Read all 46 reviews

Contributors & Developers

“The Events Calendar Category Colors” is open source software. The following people have contributed to this plugin.


“The Events Calendar Category Colors” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “The Events Calendar Category Colors” into your language.

Interested in development?

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


6.0.0 / 2018-10-20

  • move teccc_get_terms filter after filters teccc_add_terms and teccc_delete_terms
  • add default values when using teccc_add_terms filter
  • added class Bootstrap for plugin loading, now requires PHP 5.4+
  • use sanitize_hex_color() for validation of color picker data
  • fixed coloring for featured events

5.3.0 / 2018-08-03

  • fixed widget CSS
  • move list CSS to class Extras
  • fixed week CSS
  • load stylesheet all the time, more efficient as external file
  • updated class Main to use Tribe__Events__Main can now use Tribe__Events__Main::TAXONOMY
  • refactor setup of ignored terms and term data
  • add border-right to featured events
  • updated validation code upon saving options
  • use wp_upload_url() to for stylesheet to accomodate user directory preferences
  • set SSL corrected URLs for wp_upload_url(),

5.2.2 / 2018-07-28

  • fix to create CSS when files don’t exist

5.2.1 / 2018-7-28

  • cleanup old CSS files

5.2.0 / 2018-07-28

  • write standard and minified CSS to files
  • load minified CSS when WP_DEBUG is false
  • improve minify code
  • update CSS selectors for list view
  • refactor CSS strings for inline format


  • update for new tooltip title as h3
  • added some functions for adding deprecated CSS
  • added function Extras::override_customizer() for when Customizer settings need to be overridden


  • needed a space between CSS parameters, PhpStorm reformat code error


  • add Default as text color option which removes CSS color tag
  • Settings will need to be re-saved due to the new settings options

See for complete list of changes.