{"id":1964967,"date":"2025-07-11T09:00:16","date_gmt":"2025-07-11T13:00:16","guid":{"rendered":"https:\/\/theeventscalendar.com\/knowledgebase\/?p=1964967"},"modified":"2026-04-23T16:25:53","modified_gmt":"2026-04-23T20:25:53","slug":"legacy-category-colors","status":"publish","type":"post","link":"https:\/\/theeventscalendar.com\/knowledgebase\/legacy-category-colors\/","title":{"rendered":"Migrating from the Legacy Category Colors Plugin"},"content":{"rendered":"\n<p>With the release of <strong>The Events Calendar 6.14.0<\/strong>, the <strong><a href=\"https:\/\/wordpress.org\/plugins\/the-events-calendar-category-colors\/\">Category Colors<\/a><\/strong> plugin is now integrated directly into the core plugin. This guide will help you migrate your existing settings from the standalone Category Colors plugin to the new built-in system.<\/p>\n\n\n\n<p class=\"has-theme-palette-8-background-color has-background\">\ud83d\udc4b <strong>Heads up:<\/strong> With this upcoming migration, you&#8217;ll see <strong>significant changes to the User Experience (UX) and User Interface (UI)<\/strong>. This applies to <strong>both the frontend and backend<\/strong>. We wanted to let you know beforehand so you&#8217;re not surprised when you migrate!<br><br>You can preview the new functionality in <a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/the-events-calendar-category-colors\/\">this article<\/a>.<br><br>This is a one-time, irreversible migration. Your existing settings will be preserved during the process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-before-you-begin\">Before You Begin<\/h2>\n\n\n\n<p>Make sure you meet the following requirements:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You are using <strong>The Events Calendar version 6.11.0.1<\/strong> or higher<\/li>\n\n\n\n<li>The <strong>Category Colors plugin<\/strong> is installed and active<\/li>\n\n\n\n<li>You have <strong>Administrator<\/strong> access to your WordPress site<\/li>\n\n\n\n<li>We strongly recommend creating a <strong>full site backup<\/strong> before proceeding<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-how-the-migration-works\">How the Migration Works<\/h2>\n\n\n\n<p>Once you update to the latest version of The Events Calendar, the plugin will:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Detect if the standalone Category Colors plugin is active<\/li>\n\n\n\n<li>Prompt you to migrate your data via an admin notice<\/li>\n\n\n\n<li>Automatically transfer your color settings and category priorities into the new system<\/li>\n\n\n\n<li>Deactivate the old plugin once migration is complete<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-step-by-step-migration\">Step-by-Step Migration<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-1-update-the-events-calendar\">1. Update The Events Calendar<\/h4>\n\n\n\n<p>Make sure you&#8217;re running the latest version of The Events Calendar from your WordPress Plugins page.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-2-watch-for-the-migration-prompt\">2. Watch for the Migration Prompt<\/h4>\n\n\n\n<p>If the plugin detects the legacy Category Colors plugin, you\u2019ll see an admin notice:<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\u201cWe&#8217;ve detected you&#8217;re using the Category Colors plugin. This functionality is now included in The Events Calendar! To continue using category colors, migrate your settings.\u201d<\/p>\n<\/blockquote>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1564\" height=\"168\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4.png\" alt=\"\" class=\"wp-image-1964969\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4.png 1564w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4-300x32.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4-1024x110.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4-768x82.png 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/04\/image-4-1536x165.png 1536w\" sizes=\"auto, (max-width: 1564px) 100vw, 1564px\" \/><\/figure>\n\n\n\n<p>Click <strong>Start Category Colors Migration<\/strong> to begin.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-3-the-plugin-performs-pre-migration-checks\">3. The Plugin Performs Pre-Migration Checks<\/h4>\n\n\n\n<p>Before migrating, the plugin will:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check that your existing color data is valid<\/li>\n\n\n\n<li>Ensure the new system hasn\u2019t already been set up<\/li>\n\n\n\n<li>Verify your permissions<\/li>\n<\/ul>\n\n\n\n<p>If everything checks out, the migration will proceed.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-4-category-data-is-migrated\">4. Category Data is Migrated<\/h4>\n\n\n\n<p>Your existing settings\u2014including <strong>primary<\/strong>, <strong>background<\/strong>, and <strong>text colors<\/strong>, along with <strong>category priority<\/strong>\u2014will be transferred to the new taxonomy meta storage. A custom CSS file will be generated automatically.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-5-migration-complete\">5. Migration Complete<\/h4>\n\n\n\n<p>After migration:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You&#8217;ll see a success message<\/li>\n\n\n\n<li>The legacy Category Colors plugin will be <strong>automatically deactivated<\/strong><\/li>\n\n\n\n<li>You\u2019ll be redirected to <strong>Events \u2192 Event Categories<\/strong>, where you can manage your category colors going forward<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-category-colors-settings\">Category Colors Settings<\/h2>\n\n\n\n<p>After migration, go to: <strong>Events \u2192 Event Categories<\/strong> where you can:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Set or update your <strong>Primary<\/strong>, <strong>Background<\/strong>, and <strong>Font colors<\/strong><\/li>\n\n\n\n<li>Adjust <strong>Category Priority<\/strong><\/li>\n\n\n\n<li>Use the <strong>Quick Edit<\/strong> option to update colors more efficiently<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-troubleshooting-amp-rollback\">Troubleshooting &amp; Rollback<\/h2>\n\n\n\n<p>If migration fails, the system rolls back and restores the original settings, allowing you to retry.<\/p>\n\n\n\n<p>Sometimes, even after an hour of waiting, the migration might not be finished. If this occurs, you must take the following actions to complete the migration:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Back up your site, files, and database.<\/li>\n\n\n\n<li>Download The Events Calendar 6.13.0 from this page:&nbsp;<a href=\"https:\/\/wordpress.org\/plugins\/the-events-calendar\/advanced\/\">https:\/\/wordpress.org\/plugins\/the-events-calendar\/advanced\/<\/a><\/li>\n\n\n\n<li>Install and activate The Events Calendar 6.13.0.<\/li>\n\n\n\n<li>Activate the Legacy Category Colors plugin.<\/li>\n\n\n\n<li>Open its settings page and simply make a minor change; this refreshes legacy settings and ensures they\u2019re recognized.<\/li>\n\n\n\n<li>Then, update <strong>The Events Calendar<\/strong> to the latest version.<\/li>\n\n\n\n<li>Click the migrate button to run the migration again, allow it to complete, then refresh and verify success.<\/li>\n<\/ol>\n\n\n\n<p>This method effectively resets the migration workflow and resolves the issue.<\/p>\n\n\n\n<p>Check your site\u2019s error logs or reach out to our <a href=\"https:\/\/theeventscalendar.com\/support\/\">Support Team<\/a> if issues persist.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-frequently-asked-questions\">Frequently Asked Questions<\/h2>\n\n\n\n<p><strong>Will I lose my current color settings?<\/strong><br>No. All existing settings are migrated and preserved.<\/p>\n\n\n\n<p><strong>Can I continue using the old plugin?<\/strong><br>No. The old Category Colors plugin will be deactivated after migration.<\/p>\n\n\n\n<p><strong>What happens if I skip the migration?<\/strong><br>You won\u2019t be able to manage category colors until the migration is completed.<\/p>\n\n\n\n<p><strong>My category isn&#8217;t showing on the filter?<\/strong><br>If a category isn&#8217;t showing on the filter, this could be due to the category not having a Primary color set. Please follow our <a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/the-events-calendar-category-colors\/\">guide here<\/a> on editing the categories, and make sure that a Primary color is set. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-retaining-the-legacy-layout-after-migration\">Retaining the Legacy Layout after Migration<\/h2>\n\n\n\n<p>As part of integrating <strong>Category Colors<\/strong> into <strong>The Events Calendar<\/strong>, the original legend layout was removed. But don&#8217;t worry, you can still bring it back with some simple custom tweaks.<\/p>\n\n\n\n<p>Please follow the steps below to enable this layout:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Connect to your host files using an FTP connection or your hosting panel.<\/li>\n\n\n\n<li>Copy the file&nbsp;<code>category-color-picker.php<\/code> &nbsp;from&nbsp;<code>wp-content\/plugins\/the-events-calendar\/src\/views\/v2\/components\/top-bar<\/code><\/li>\n\n\n\n<li>Put the file under&nbsp;<code>wp-content\/themes\/[your-theme]\/tribe\/events\/v2\/components\/top-bar\/<\/code><\/li>\n\n\n\n<li>Open the file in the text editor and replace the code with the first one provided&nbsp;<a href=\"https:\/\/gist.github.com\/andrasguseo\/4aced313debb1bf9952e5d9a127d14ef\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/li>\n\n\n\n<li>Enable <strong>Custom CSS<\/strong> option under <strong>Events &gt; Settings &gt; Display &gt; Category Colors<\/strong>.<\/li>\n\n\n\n<li>Then go to&nbsp;<strong>Appearance &gt; Customize &gt; Additional CSS<\/strong>&nbsp;and add the CSS code that was given on&nbsp;the same page:<br><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1457\" height=\"850\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-07-08-at-9.00.04-AM.png\" alt=\"\" class=\"wp-image-1966464\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-07-08-at-9.00.04-AM.png 1457w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-07-08-at-9.00.04-AM-300x175.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-07-08-at-9.00.04-AM-1024x597.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-07-08-at-9.00.04-AM-768x448.png 768w\" sizes=\"auto, (max-width: 1457px) 100vw, 1457px\" \/><\/figure>\n\n\n\n<p>If your site has caching enabled, you should see the legacy <strong>Category Colors<\/strong> layout after clearing the cache.<\/p>\n\n\n\n<p class=\"has-theme-palette-8-background-color has-background\">\ud83d\udc4b The CSS in the customizer may not be applicable to certain themes, such as Divi. So it is best to use other methods:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>A third-party plugin that lets you add CSS, e.g., <a href=\"https:\/\/wordpress.org\/plugins\/code-snippets\/\" rel=\"nofollow\">Code Snippets<\/a>.<\/li>\n\n\n\n<li>The theme&#8217;s style.css file, preferably the child theme.<\/li>\n\n\n\n<li>If the theme has a specific option to add custom CSS, e.g.,&nbsp;<strong>Divi &gt; Theme Options &gt; Custom CSS<\/strong>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1888\" height=\"777\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM.jpeg\" alt=\"\" class=\"wp-image-1966461\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM.jpeg 1888w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM-300x123.jpeg 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM-1024x421.jpeg 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM-768x316.jpeg 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/08\/Image-2025-08-17-at-3.42.59-PM-1536x632.jpeg 1536w\" sizes=\"auto, (max-width: 1888px) 100vw, 1888px\" \/><\/figure>\n\n\n\n<p>This change applies to calendar shortcodes as well as the main calendar page.<\/p>\n\n\n\n<p>Version 6.14.2 of The Events Calendar was used to test this code.<\/p>\n\n\n\n<p><br>Review following guides on customizing The Events Calendar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/customizing-template-files-2\/\">Customizing Template Files<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/calendar-template-files-v2\/\">The Events Calendar Template Files<\/a><\/li>\n<\/ul>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>With the release of The Events Calendar 6.14.0, the Category Colors plugin is now integrated directly into the core plugin. This guide will help you migrate your existing settings from the standalone Category Colors plugin to the new built-in system. \ud83d\udc4b Heads up: With this upcoming migration, you&#8217;ll see significant changes to the User Experience&#8230;<\/p>\n","protected":false},"author":71,"featured_media":1955565,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"ep_exclude_from_search":false,"footnotes":""},"categories":[347],"tags":[],"stellar-product-taxonomy":[161],"class_list":["post-1964967","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-how-to","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":347,"label":"How To"}],"stellar-product-taxonomy":[{"value":161,"label":"The Events Calendar"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"Luan Luta","author_link":"https:\/\/theeventscalendar.com\/knowledgebase\/author\/luanluta\/"},"comment_info":0,"category_info":[{"term_id":347,"name":"How To","slug":"how-to","term_group":0,"term_taxonomy_id":347,"taxonomy":"category","description":"","parent":0,"count":109,"filter":"raw","term_order":"0","cat_ID":347,"category_count":109,"category_description":"","cat_name":"How To","category_nicename":"how-to","category_parent":0}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1964967","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/users\/71"}],"replies":[{"embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1964967"}],"version-history":[{"count":9,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1964967\/revisions"}],"predecessor-version":[{"id":1969902,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1964967\/revisions\/1969902"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media\/1955565"}],"wp:attachment":[{"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=1964967"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1964967"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1964967"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1964967"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}