{"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-03T16:10:04","modified_gmt":"2026-04-03T20:10:04","slug":"migrating-from-the-standalone-category-colors-plugin-to-the-events-calendar","status":"publish","type":"post","link":"https:\/\/theeventscalendar.com\/knowledgebase\/migrating-from-the-standalone-category-colors-plugin-to-the-events-calendar\/","title":{"rendered":"Migrating from the standalone Category Colors Plugin to The Events Calendar"},"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<h3 class=\"wp-block-heading\" id=\"h-1-update-the-events-calendar\">1. Update The Events Calendar<\/h3>\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<h3 class=\"wp-block-heading\" id=\"h-2-watch-for-the-migration-prompt\">2. Watch for the Migration Prompt<\/h3>\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<h3 class=\"wp-block-heading\" id=\"h-3-the-plugin-performs-pre-migration-checks\">3. The Plugin Performs Pre-Migration Checks<\/h3>\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<h3 class=\"wp-block-heading\" id=\"h-4-category-data-is-migrated\">4. Category Data is Migrated<\/h3>\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<h3 class=\"wp-block-heading\" id=\"h-5-migration-complete\">5. Migration Complete<\/h3>\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-where-to-manage-category-colors-now\">Where to Manage Category Colors Now<\/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:\u00a0<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-question\">Frequently Asked Question<\/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<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":[327,307,46],"tags":[],"stellar-product-taxonomy":[161],"class_list":["post-1964967","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-category-colors","category-filtering-categories","category-integrations","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":327,"label":"Category Colors"},{"value":307,"label":"Filtering &amp; Categories"},{"value":46,"label":"Integrations"}],"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":327,"name":"Category Colors","slug":"category-colors","term_group":0,"term_taxonomy_id":327,"taxonomy":"category","description":"","parent":61,"count":4,"filter":"raw","term_order":"0","cat_ID":327,"category_count":4,"category_description":"","cat_name":"Category Colors","category_nicename":"category-colors","category_parent":61},{"term_id":307,"name":"Filtering &amp; Categories","slug":"filtering-categories","term_group":0,"term_taxonomy_id":307,"taxonomy":"category","description":"","parent":61,"count":2,"filter":"raw","term_order":"0","cat_ID":307,"category_count":2,"category_description":"","cat_name":"Filtering &amp; Categories","category_nicename":"filtering-categories","category_parent":61},{"term_id":46,"name":"Integrations","slug":"integrations","term_group":0,"term_taxonomy_id":46,"taxonomy":"category","description":"","parent":0,"count":82,"filter":"raw","term_order":"0","cat_ID":46,"category_count":82,"category_description":"","cat_name":"Integrations","category_nicename":"integrations","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":6,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1964967\/revisions"}],"predecessor-version":[{"id":1968539,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1964967\/revisions\/1968539"}],"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}]}}