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.

Requires PHP 5.3 or greater.


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


  1. Upload the entire /the-events-calendar-category-colors/ folder to the /wp-content/plugins/ directory.
  2. Activate the plugin.
  3. Go to the Category Colors tab of The Event Calendar Settings page.


Installation Instructions
  1. Upload the entire /the-events-calendar-category-colors/ folder to the /wp-content/plugins/ directory.
  2. Activate the plugin.
  3. Go to the Category Colors tab of The Event Calendar Settings page.
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.


Fantastic plugin, support

Andy Fragen has done an amazing job with this free plugin for The Events Calendar. Very easy to set up and manipulate. If it were possible, I’d give this a sixth star because of the incredibly helpful troubleshooting and support that Andy provides on the forum and GitHub.

awesome thanks andy!

needed a little tweaking to get just right with my avada theme – andy worked it out and upgraded the plugin and it’s working perfect now. awesome job and awesome plugin! thanks!

Great Plugin!

This is a GREAT plugin. Simple to setup. Simple to use. Did exactly what I wanted it to do. Thank you very much!!!

Read all 40 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 1 locale. 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.



  • 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


  • updated autoloader
  • no longer add CSS for transparency, allows for minimal overlapping styles


  • simplify check for shortcodes



  • fixed PHP Notices when hide setting selected
  • update mobile CSS to override display:none in TEC mobile CSS


  • fixed PHP Notice with more specific test of WP_POST
  • fixed text color for featured events #79


  • fixed PHP Notice
  • added additional link color CSS selector for #tribe-events-content


  • added more shortcodes to list for support
  • updated some week view CSS


  • fixed ECP week view
  • added support for ECP week view shortcode
  • make Autoloader a drop-in


  • move graceful exit to just before plugin initialization


  • added support for tribe shortcodes
  • graceful failure if The Events Calendar is not active


  • added CSS selector to override Customizer month view


  • added filters and functions to provide WPML compatibility thanks @jvier for testing


  • added our own PHP version check
  • added filter teccc_fix_category_background_color for those pesky themes that have Events Calendar specific CSS, I’m looking at you Avada


  • moved older changes into
  • modified filter teccc_fix_category_link_color for those really pesky themes. The modification will require an adjustment to the way the filter is called and returned. Refer to the wiki for details.
  • above filter modification fixes issue with Read More links.


  • added filter teccc_fix_category_link_color for those pesky themes that override everything.
  • fixed ETag header in CSS
  • removed Filter Bar coloring
  • further optimized CSS minification


  • refactor mobile CSS and add filter teccc_mobile_css


  • fix superpowers to be more inclusive in find – thanks Lisa


  • fix to display title full width, most noticeable in photo view
  • sorry about all the quick updates, just trying to fix issues as I’m made aware of them.


  • fix for mobile TEC 4.0


  • fix week view all day color


  • fix week view link color


  • update for The Events Calendar 4.0
  • fix for WordPress installation in subfolder – thanks @IndigoStarfish
  • tested to WordPress 4.4


  • escape all things for better security
  • tweak declaration/initiation of variables
  • tested to 4.3


  • change CSS load order to ( PHP_MAX_INT – 100 ) to allow for overriding


  • fix for PHP notice on Settings


  • fix for v3.10 all day week view.


  • update for Tribe__Events__Filterbar__View with CSS fix too.


  • update for new Tribe__Events__Main and Tribe__Events__Pro__Main classes
  • fix CSS for week view


  • add setting to show hidden categories – for @mending


  • add setting to hide category on frontend
  • fix a number of PHP notices


  • fix for fatal error. Need to load namespaced class as variable as PHP < 5.3 chokes.


  • quick fix for fatal error, I think due to naming method in WPUpdatePhp


  • don’t use variable for class name
  • switch PHP version check to use WPUpdatePhp


  • don’t minify CSS when ?debug_css – this to help in debugging
  • requires PHP 5.3 or greater as requires namespacing

  • class aliases for backwards compatibility for users of ECP 3.9 or lower

  • renamed directory and class names to allow for PSR 4 loading
  • fix all text domain slugs and update POs
  • add CSS selectors for TEC 3.10

See for complete list of changes.