Hello everyone, I am trying to make my forum fully compatible with multiple languages, but I am not sure how to translate the custom text elements I have added to the UI. [image] As you can see in the screenshot: Left Sidebar: I added several custom links (e.g., “Küresel Liderlik Tablosu”, “RSS Beslemesi”) using the “Edit Custom Section” feature. Top Navigation: I added custom menu items (e.g., “Gündem”, “Etkinlikler”) by inserting code into the section via Themes. Currently, all of these are hardcoded in one language. What is the best practice for localizing these specific additions? Is there a way to use translation keys so they automatically adapt to the user’s selected interface language? Any guidance or examples would be greatly appreciated. Thank you!

Thanks for letting me know about the update! As for the top navigation links, I managed to come up with a solution and opened a PR for it: Show topic counts for custom nav links matching /new and /unread and Add per-language translation support for custom nav links (#58) main ← akanora:main merged 12:48AM - 23 Jul 26 UTC (UTC) [image] akanora +208 -9 Custom nav links pointing to /new or /unread now display the topic count in pare…ntheses (e.g., "New (24)"), matching the behavior of Discourse's built-in navigation items. The count is retrieved from the TopicTrackingState service and updates reactively. Links with other URLs remain unchanged. Admins can now provide locale-specific overrides for display_name and title on each nav link, while locales without an override automatically fall back to the default value. So I think that resolves the issues I was having.

There is a feature request for #1 here: Feature request: make it possible to translate custom sidebar links and sections. So I don’t think it’s currently possible. You can vote on it to show that it matters to you. That said, I know custom badges can be translated via the rails console, but I haven’t tried if that also works for the sidebar. In case you want to try it, it was explained here: How can badges and groups be localized (multilingual)? - #8 by nat Theme components support localization. There is a short guide about it here: [image] Add localizable strings to themes and theme components Developer Guides For those looking to add custom languages and translations to a Discourse theme or theme component, they can now include localised strings, which are made available for use in UI components. Translations are stored in the same format as core/plugin translations, and can be used in almost the same way. Themes can supply translation files in a format like /locales/{locale}.yml. These files should be valid YAML, with a single top level key equal to the locale being defined. These can be defined us… I usually prefer to look at examples. There are lots of theme components in #theme-component. I think Topic Status Filter is a quite simple one. Custom Top Navigation Links might be a helpful example too. It’s closer to what you want to do, but it doesn’t support localizable links, because combining that with them being configurable is difficult. I don’t know if something similar is possible directly in the section.

Thanks for the info! I actually tried the Custom Top Navigation Links component, but it caused that section to not show up at all on mobile. That’s why I ended up using injection instead.

As of this post, this feature has been added: [image] Feature request: make it possible to translate custom sidebar links and sections Feature This is now done - FEATURE: Allow admins to localize custom sidebar section and links - Pull Request #41795 - discourse/discourse - GitHub Some screenshots: [image] [image] Will be updating the main docs as well. I’ll be closing this topic on a timer. Please feel free to create a new topic for any follow ups or feedback once this is closed.

Comment traduire les éléments ajoutés via "Modifier la section personnalisée" et le <head> du thème ?

Assistance produit

NateDhaliwal (Nate Dhaliwal) Juillet 22, 2026, 7:48 4

À ce jour, cette fonctionnalité a été ajoutée :

Sujet		Réponses	Vues
Making a theme translation for Custom Header Links Development custom-header-links	5	458	Mai 19, 2020
Feature request: make it possible to translate custom sidebar links and sections Feature sidebar , ai , dynaloc , content-localization	6	721	Juillet 22, 2026
Add localizable strings to themes and theme components Developer Guides how-to , theme-guides	22	6240	Août 9, 2024
Localisation of custom navbar and footer Development	2	887	Novembre 11, 2021
Custom content localization Feature content-localization	5	2566	Août 10, 2016

Comment traduire les éléments ajoutés via "Modifier la section personnalisée" et le <head> du thème ?

Sujets connexes