In the past, you could override the .hbs template for and Discourse Route or Component by adding an identically named file in the templates/ directory of your theme and plugin. This was very powerful, but also came with significant maintainability issues. Therefore, we’ve been recommending against template overrides over the last few years, and officially deprecated them in November 2024. Nowadays, the better solution is to use Wrapper Plugin Outlets to render content in place of core content. This month (March 2025) we will be introducing an admin warning banner for template overrides, and plan to fully remove support before the end of Q2. Timeline (estimated dates - subject to change) :white_check_mark: November 2024 - deprecation introduced :white_check_mark: March 2025 - admin warning banner enabled :white_check_mark: June 2025 - removal of functionality (targetting w/c 2nd June) Upgrading themes / plugins Theme and plugin developers should refer to the Plugin Outlet guide to learn more about wrapper plugin outlets. Feel free to open PRs or #dev topics if you’d like to request a new extension point for your use-case.

Is there a way to easily see which theme/plugin is triggering this admin notice? I looked through all of my themes and plugins and don’t see a templates/ directory in the root of their Git repositories for any of them.

[image] Jonah Aragon: don’t see a templates/ directory in the root It’s in /assets/javascripts/discourse or in /javascripts/discourse, not in the root.

The warning banner should show the name of the theme/plugin. It’ll also be printed in the browser developer console. If not, perhaps we have a problem with the deprecation - would you be able to share a link to an affected site?

Thank you. It did not show in the warning banner but it did show in the developer console, although not very clearly. [2025-03-05 at 10.00.40] Turned out to be this component. [image] DuckDuckGo Search Suggestions Theme component Solves Is there a way to suggest DuckDuckGo instead of Google for failed search UI?. A Discourse theme component to use DuckDuckGo as the suggested search system, instead of Google! p.s. You’ll probably want to customize some of the text strings to stop mentioning Google, too.

Thanks @JonahAragon1. The theme identification should be much clearer than that, so I’ll get that fixed up :eyes:

This change will fix the warning banner so it identifies themes more clearly: [SCR-20250306-otnz]

Have you find a solution to get back DDG as search suggestion? I’ve disabled the component for now.

No, I just decided to disable the form entirely. I don’t think anyone in my community uses it and I don’t really see the usefulness. I saw the component author proposed an update that requires a core change, so it’ll probably be working again soon. common/common.scss 940ae61c4 // Hide Google search form .google-search-form { display: none; }

does it mean that the experimental user card will be introduced into core before this fully deprecates? I currently get this warning for this component GitHub - discourse/experimental-usercard · GitHub

We’ve archived the experimental-usercard repository, and don’t intend to update the theme component any further. So I’m afraid you will need to disable it before template overrides are blocked in June 2025. We do hope to incorporate some of the experiment into core at some point, but don’t have a specific timeline on that. The user-card is a very heavily-customized part of the UI, so landing large changes to it will require careful planning and changes across the ecosystem.

Removing support for "template overrides" and mobile-specific templates

Development

david (David Taylor) June 6, 2025, 1:45pm 16

Support for template overrides and mobile-specific templates has now been dropped.

Topic		Replies	Views
(not recommended) Overriding Discourse templates from a Theme or Plugin Developer Guides how-to	9	3189	March 7, 2024
Component template resolving pink banner Product Support	12	590	June 16, 2025
Modernizing inline script tags for templates & JS API Development dev-news	46	6295	March 25, 2026
How to track down `(id:discourse.component-template-resolving)` Product Support	5	284	October 22, 2025
How to identify which theme/component/plugin needs an update? Product Support	1	246	June 15, 2025

Removing support for "template overrides" and mobile-specific templates

Related topics