In the latest version of Discourse, using .hbs files in themes and plugins is deprecated. Support for this file format will be removed after the next ESR release. Handlebars templates should be replaced with the more modern .gjs format, which provides a much better development experience, and will …

[image] david: after the next ESR release Do I understand correctly that 2026.7 will still support hbs files and 2027.1 will be the first ESR release that doesn’t?

Yes, exactly. It’s most likely that we will drop support in 2026.8.0-latest. But it’s possible it could be later, depending on real-world data and community feedback.

Just came across this one, guess it needs to be updated [image] Modernizing inline script tags for templates & JS API Templates introduced using this method should be moved to dedicated .hbs files, or refactored into gjs files. To keep as HBS, connector templates can be placed in: {theme}/java…

Thanks! Hopefully most people have already taken care of those, since they have been deprecated with an admin banner for almost a year. Just in case, I added this note: [image] Modernizing inline script tags for templates & JS API :warning: Since March 2026, .hbs files are also deprecated. Afte…

Pour ma part, j ai essayé pour mon ptit plugin perso et j ai réussi avec l aide de ask Discourse qui a fusionné mes fichiers hbs et js en un fichier gjs. Je conseil grandement l utilisation de ask Discourse pour résoudre ce problème pour ceux comme moi ont d des difficultés de développement :rofl:

That’s great! I’ve added a note about ask.discourse.com in the OP as well. If you only have a few files, it can work very well :100:

I have no idea what a .gjs file is, nor time to learn about them and re-write multiple plugins. This is ridiculous. What is the point of even having a plugin API if it is as fragile as the one in Discourse? Maintaining plugins for this forum software has been nothing but trouble.

It’s far from ridiculous. If you don’t have the budget or bandwidth to manage customisations then I would urge you to simplify your setup. It’s imho the (reasonable) price you pay for remaining on a cutting edge high velocity platform that keeps on innovating, improving performance, deploys freque…

[image] LeoDavidson: I have no idea what a .gjs file is, nor time to learn about them and re-write multiple plugins You don’t even have to know what a .gjs file is: Automatically updating themes and plugins to .gjs file format

cela n’a pas marché pour mon petit plugin. :sob: Mais avec l’aide de ask.discourse.com , il a lu mon code et m’a converti mon fichier hbs et js en .gjs donc il ne faut pas hésiter si la première méthode ne fonctionne pas

Deprecating .hbs file extension in themes and plugins

Development

david (David Taylor) March 25, 2026, 9:36am 5

Thanks! Hopefully most people have already taken care of those, since they have been deprecated with an admin banner for almost a year. Just in case, I added this note:

Topic		Replies	Views
Case study of an amateur plugin author Development	11	173	May 4, 2026
Deprecating .js.es6 file extensions in themes and plugins Development dev-news	8	185	April 7, 2026
Modernizing inline script tags for templates & JS API Development dev-news	47	4398	March 25, 2026
Automatically updating themes and plugins to .gjs file format Development dev-news	9	380	May 2, 2026
When to switch themes/plugins to `.gjs`? Development	27	617	January 5, 2026

Deprecating .hbs file extension in themes and plugins

Related topics