Diagnostic Checklist<\/h2>\n\n\n\nFolder Structure and File Paths<\/h4>\n\n\n\n
The most common reason an override is ignored is a path mismatch. The folder structure in your theme must exactly mirror the plugin’s The plugin uses A single character difference \u2014 including case \u2014 will prevent an override from being recognized. The file name in your theme must exactly match the original file name in the plugin, including capitalization. For example, Cached versions of templates or assets can mask your changes. Clear each layer:<\/p>\n\n\n\n Another plugin may be interfering with TEC’s template loading. To test: temporarily deactivate all plugins except The Events Calendar and its add-ons, then check whether your overrides work. If they do, reactivate plugins one at a time \u2014 checking after each \u2014 until you find the conflict. See Testing for Conflicts<\/a> for a complete guide.<\/p>\n\n\n\n Some themes override TEC template loading in ways that prevent custom files from being picked up. To isolate: temporarily switch to a default WordPress theme (Twenty Twenty-Three or similar) and copy your overrides into that theme’s directory. If they work there, the issue is with your active theme. Check your theme’s documentation or support for guidance on how it handles template loading.<\/p>\n\n\n\n Always test theme or plugin updates in a staging environment<\/a> before applying them to production, and keep backups so you can roll back.<\/p>\n\n\n\n PHP errors caused by missing functions or bad file paths often don’t surface visibly \u2014 they silently prevent templates from loading. Enable WordPress debugging to catch them:<\/p>\n\n\n\n If the web server can’t read your override files, they will be silently skipped. The recommended permissions are:<\/p>\n\n\n\n If your Go to Events \u2192 Settings \u2192 Display \u2192 Calendar \u2192 Events template<\/strong>. If a theme-specific template is selected and that template has changed or broken, try switching to Default Events Template<\/strong> and saving. This often restores basic layout when a custom or theme-specific template is the cause.<\/p>\n\n\n\n The diagnostic steps above apply in all cases. When the problem started immediately after a theme or plugin update, the following additional causes are likely and worth checking first.<\/p>\n\n\n\n Updates break template overrides and display for a few common reasons:<\/p>\n\n\n\n Compare your override files with the current version in the plugin. Look for any function calls in your override that have been deprecated or removed, and replace them with the current equivalents. For example, if your override calls The safest approach is to start fresh: copy the updated plugin template file into your theme override path, then re-apply your customizations around the new code.<\/p>\n\n\n\n Use your browser’s inspector to compare the rendered markup before and after the update \u2014 class names, container structure, and element nesting may have changed. Write new CSS targeting the updated markup in a child theme<\/a> or via the Additional CSS<\/a> panel. See Customizing CSS in The Events Calendar<\/a> for more on finding and targeting the right CSS classes.<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" This article covers two closely related problems: template overrides that aren’t taking effect, and display or layout issues that appear after a theme or plugin update. Many of the diagnostic steps apply to both, with additional sections for the causes and fixes that are specific to post-update breakage. Common Symptoms Here are the most common…<\/p>\n","protected":false},"author":63,"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":[24,84],"tags":[],"stellar-product-taxonomy":[],"class_list":["post-1965938","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-customizing","category-theming-overview"],"acf":[],"taxonomy_info":{"category":[{"value":24,"label":"Customizations"},{"value":84,"label":"Templating & Layout"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"Tristan","author_link":"https:\/\/theeventscalendar.com\/knowledgebase\/author\/tristan\/"},"comment_info":0,"category_info":[{"term_id":24,"name":"Customizations","slug":"customizing","term_group":0,"term_taxonomy_id":24,"taxonomy":"category","description":"","parent":0,"count":76,"filter":"raw","term_order":"0","cat_ID":24,"category_count":76,"category_description":"","cat_name":"Customizations","category_nicename":"customizing","category_parent":0},{"term_id":84,"name":"Templating & Layout","slug":"theming-overview","term_group":0,"term_taxonomy_id":84,"taxonomy":"category","description":"","parent":24,"count":25,"filter":"raw","term_order":"0","cat_ID":84,"category_count":25,"category_description":"","cat_name":"Templating & Layout","category_nicename":"theming-overview","category_parent":24}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1965938","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\/63"}],"replies":[{"embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1965938"}],"version-history":[{"count":8,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1965938\/revisions"}],"predecessor-version":[{"id":1969325,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1965938\/revisions\/1969325"}],"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=1965938"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1965938"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1965938"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1965938"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\/src\/views\/v2\/<\/code> directory. For example, to override the-events-calendar\/src\/views\/v2\/list\/event\/featured-image.php<\/code>, the file must be at:<\/p>\n\n\n\nwp-content\/themes\/your-theme\/tribe\/events\/v2\/list\/event\/featured-image.php\n<\/pre><\/div>\n\n\n
tribe\/<\/code> as the root override folder for current views. See Customizing Template Files<\/a> for the full folder reference per plugin. You can also find the correct override path in the header comment at the top of each template file.<\/p>\n\n\n\n![\"A](\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2025\/07\/image-3.png\")
<\/figure>\n\n\n\nFile Naming and Case Sensitivity<\/h4>\n\n\n\n
single-event.php<\/code> is correct; Single-Event.php<\/code> is not.<\/p>\n\n\n\nClear All Caches<\/h4>\n\n\n\n
\n
Check for Plugin Conflicts<\/h4>\n\n\n\n
Check for Theme Conflicts<\/h4>\n\n\n\n
Enable Debugging and Check Error Logs<\/h4>\n\n\n\n
\n
wp-content\/debug.log<\/code> for errors related to TEC templates.<\/li>\n\n\n\nFile Permissions<\/h4>\n\n\n\n
\n
755<\/code> (rwxr-xr-x) \u2014 owner can read, write, execute; group and others can read and execute.<\/li>\n\n\n\n644<\/code> (rw-r–r–) \u2014 owner can read and write; group and others can read only.<\/li>\n<\/ul>\n\n\n\ntribe\/<\/code> directory or any of its files have more restrictive permissions (e.g. 600<\/code> for files), the server may not be able to access them. Your hosting control panel’s file manager can show and correct permissions, or contact your host for assistance.<\/p>\n\n\n\nCheck the Display Template Setting<\/h4>\n\n\n\n
After a Theme or Plugin Update<\/h2>\n\n\n\n
Why Updates Break Templates<\/h4>\n\n\n\n
\n
Fixing Broken Template Overrides After an Update<\/h4>\n\n\n\n
tribe_events_the_notices()<\/code>, update it to tribe_the_notices()<\/code>.<\/p>\n\n\n\nFixing CSS and Styling Conflicts<\/h4>\n\n\n\n