redhat-developer · openshift-merge-bot · Feb 4, 2026 · Feb 3, 2026 · Feb 3, 2026 · Feb 3, 2026
diff --git a/docs/customization.md b/docs/customization.md
@@ -264,6 +264,17 @@ Example of JSON translation file, where the top-level key is the plugin translat
 }
 ```
 
+### Translation priority order
+
+Translations are resolved in this order (highest priority first):
+
+1. **app-config overrides** — Paths listed in `i18n.overrides` in `app-config.yaml`. This is the only level users should change for custom labels.
+2. **`/translations` JSON files** — Files under `translations/` (e.g. in the repo or mounted at `/src/translations/`). **RHDH override files (`rhdh-<locale>.json`) must win over Backstage defaults (`backstage-<locale>.json`)** when the same key exists in both. For 1.9 this is ensured by processing files in order: `backstage-*.json`, then `community-plugins-*.json`, then `rhdh-*.json`. Going forward, the i18n CLI or build pipeline should enforce this order.
+3. **Locale TS files** — App sources under `app/src/.../<locale>.ts` (e.g. `packages/app/src/translations/scaffolder/ja.ts`). Left as-is for 1.9.
+4. **Fallback English** — Default messages in `app/src/.../ref.ts` (e.g. `rhdhMessages` in `packages/app/src/translations/rhdh/ref.ts`).
+
+Levels 2–4 are for internal management only; only level 1 is user-configurable.
+
 ### Customizing Translations
 
 In a translation override JSON file, you can:

diff --git a/packages/app/src/components/AppBase/AppBase.tsx b/packages/app/src/components/AppBase/AppBase.tsx
@@ -105,12 +105,7 @@ const AppBase = () => {
               >
                 {entityPage(entityTabOverrides)}
               </Route>
-              <Route
-                path="/create"
-                element={
-                  <ScaffolderPage headerOptions={{ title: 'Self-service' }} />
-                }
-              >
+              <Route path="/create" element={<ScaffolderPage />}>
                 <ScaffolderFieldExtensions>
                   {scaffolderFieldExtensions.map(
                     ({ scope, module, importName, Component }) => (

diff --git a/packages/app/src/components/Root/Root.tsx b/packages/app/src/components/Root/Root.tsx
@@ -594,7 +594,7 @@ export const Root = ({ children }: PropsWithChildren<{}>) => {
                 {showAdministration && (
                   <>
                     <SidebarDivider />
-                    <SidebarGroup label="Administration">
+                    <SidebarGroup label={t('menuItem.administration')}>
                       {renderMenuItems(true, true)}
                     </SidebarGroup>
                   </>

diff --git a/packages/app/src/translations/rhdh/de.ts b/packages/app/src/translations/rhdh/de.ts
@@ -93,7 +93,6 @@ export default createTranslationMessages({
     'signIn.providers.saml.message': 'Mit SAML anmelden',
 
     // App translations
-    'app.scaffolder.title': 'Self-Service',
     'app.search.title': 'Suchen',
     'app.search.resultType': 'Ergebnistyp',
     'app.search.softwareCatalog': 'Software-Katalog',

diff --git a/packages/app/src/translations/rhdh/es.ts b/packages/app/src/translations/rhdh/es.ts
@@ -94,7 +94,6 @@ export default createTranslationMessages({
     'signIn.providers.saml.message': 'Iniciar sesión con SAML',
 
     // App translations
-    'app.scaffolder.title': 'Autoservicio',
     'app.search.title': 'Buscar',
     'app.search.resultType': 'Tipo de resultado',
     'app.search.softwareCatalog': 'Catálogo de software',

diff --git a/packages/app/src/translations/rhdh/fr.ts b/packages/app/src/translations/rhdh/fr.ts
@@ -85,7 +85,6 @@ export default createTranslationMessages({
     'catalog.entityPage.definition.title': 'Définition',
     'catalog.entityPage.diagram.title': 'Diagramme du système',
     'catalog.entityPage.workflows.title': 'Flux de travail',
-    'app.scaffolder.title': 'Self-service',
     'app.search.title': 'Recherche',
     'app.search.resultType': 'Type de résultat',
     'app.search.softwareCatalog': 'Catalogue de logiciels',

diff --git a/packages/app/src/translations/rhdh/it.ts b/packages/app/src/translations/rhdh/it.ts
@@ -85,7 +85,6 @@ export default createTranslationMessages({
     'catalog.entityPage.definition.title': 'Definizione',
     'catalog.entityPage.diagram.title': 'Diagramma di sistema',
     'catalog.entityPage.workflows.title': 'Flussi di lavoro',
-    'app.scaffolder.title': 'Self-service',
     'app.search.title': 'Ricerca',
     'app.search.resultType': 'Tipo di risultato',
     'app.search.softwareCatalog': 'Catalogo software',

diff --git a/packages/app/src/translations/rhdh/ja.ts b/packages/app/src/translations/rhdh/ja.ts
@@ -85,7 +85,6 @@ export default createTranslationMessages({
     'catalog.entityPage.definition.title': '定義',
     'catalog.entityPage.diagram.title': 'システム図',
     'catalog.entityPage.workflows.title': 'ワークフロー',
-    'app.scaffolder.title': 'セルフサービス',
     'app.search.title': '検索',
     'app.search.resultType': '結果タイプ',
     'app.search.softwareCatalog': 'ソフトウェアカタログ',

diff --git a/packages/app/src/translations/rhdh/ref.ts b/packages/app/src/translations/rhdh/ref.ts
@@ -157,9 +157,6 @@ export const rhdhMessages = {
     },
   },
   app: {
-    scaffolder: {
-      title: 'Self-service',
-    },
     search: {
       title: 'Search',
       resultType: 'Result Type',

diff --git a/packages/app/src/translations/scaffolder/fr.ts b/packages/app/src/translations/scaffolder/fr.ts
diff --git a/packages/app/src/translations/scaffolder/it.ts b/packages/app/src/translations/scaffolder/it.ts
@@ -21,6 +21,10 @@ export default createTranslationMessages({
   ref: scaffolderTranslationRef,
   full: false,
   messages: {
+    'templateListPage.title': 'Self-service',
+    'templateListPage.pageTitle': 'Self-service',
+    'templateWizardPage.title': 'Self-service',
+    'templateWizardPage.pageTitle': 'Self-service',
     'templateListPage.contentHeader.registerExistingButtonTitle':
       'Importa un repository Git esistente',
   },

diff --git a/packages/app/src/translations/scaffolder/ja.ts b/packages/app/src/translations/scaffolder/ja.ts
@@ -21,6 +21,10 @@ export default createTranslationMessages({
   ref: scaffolderTranslationRef,
   full: false,
   messages: {
+    'templateListPage.title': 'セルフサービス',
+    'templateListPage.pageTitle': 'セルフサービス',
+    'templateWizardPage.title': 'セルフサービス',
+    'templateWizardPage.pageTitle': 'セルフサービス',
     'templateListPage.contentHeader.registerExistingButtonTitle':
       '既存の Git リポジトリーのインポート',
   },

diff --git a/packages/app/src/translations/scaffolder/scaffolder-en.ts b/packages/app/src/translations/scaffolder/scaffolder-en.ts
@@ -5,6 +5,10 @@ const en = createTranslationMessages({
   ref: scaffolderTranslationRef,
   full: false, // False means that this is a partial translation
   messages: {
+    'templateListPage.title': 'Self-service',
+    'templateListPage.pageTitle': 'Self-service',
+    'templateWizardPage.title': 'Self-service',
+    'templateWizardPage.pageTitle': 'Self-service',
     'templateListPage.contentHeader.registerExistingButtonTitle':
       'Import an existing Git repository',
   },

diff --git a/packages/app/src/utils/dynamicUI/extractDynamicConfig.ts b/packages/app/src/utils/dynamicUI/extractDynamicConfig.ts
@@ -32,6 +32,8 @@ export type DynamicRouteMenuItem =
 export type MenuItemConfig = {
   icon?: string;
   title?: string;
+  titleKey?: string;
+  textKey?: string;
   priority?: number;
   parent?: string;
 };

diff --git a/packages/app/src/utils/dynamicUI/extractDynamicConfigFrontend.ts b/packages/app/src/utils/dynamicUI/extractDynamicConfigFrontend.ts
@@ -28,14 +28,16 @@ export function compareMenuItems(a: MenuItem, b: MenuItem) {
 function convertMenuItemsRecordToArray(
   menuItemsRecord: Record<string, MenuItemConfig>,
 ): MenuItem[] {
-  return Object.keys(menuItemsRecord).map(
-    key =>
-      ({
-        ...menuItemsRecord[key],
-        children: [],
-        name: key,
-      }) as MenuItem,
-  );
+  return Object.keys(menuItemsRecord).map(key => {
+    const config = menuItemsRecord[key];
+    const { textKey, titleKey: configTitleKey, ...rest } = config;
+    return {
+      ...rest,
+      name: key,
+      children: [],
+      titleKey: textKey ?? configTitleKey,
+    } as MenuItem;
+  });
 }
 
 export function buildTree(menuItemsArray: MenuItem[]): MenuItem[] {

diff --git a/translations/backstage-fr.json b/translations/backstage-fr.json
@@ -60,10 +60,10 @@
   "catalog-import": {
     "fr": {
       "buttons.back": "Retour",
-      "defaultImportPage.headerTitle": "Enregistrer un composant existant",
+      "defaultImportPage.headerTitle": "Importer un dépôt Git existant",
       "defaultImportPage.contentHeaderTitle": "Commencez à suivre votre composant dans {{appTitle}}",
       "defaultImportPage.supportTitle": "Commencez à suivre votre composant dans {{appTitle}} en l'ajoutant au catalogue de logiciels.",
-      "importInfoCard.title": "Enregistrer un composant existant",
+      "importInfoCard.title": "Importer un dépôt Git existant",
       "importInfoCard.deepLinkTitle": "En savoir plus sur le catalogue de logiciels",
       "importInfoCard.linkDescription": "Saisissez l'URL de votre référentiel de code source pour l'ajouter à {{appTitle}}.",
       "importInfoCard.fileLinkTitle": "Lien vers un fichier d'entité existant",
@@ -469,17 +469,17 @@
       "templateEditorPage.templateEditorTextArea.refreshIconTooltip": "Recharger le fichier",
       "templateEditorPage.templateEditorTextArea.emptyStateParagraph": "Veuillez sélectionner une action dans le menu fichier.",
       "templateEditorPage.templateFormPreviewer.title": "Charger le modèle existant",
-      "templateListPage.title": "Créer un nouveau composant",
+      "templateListPage.title": "Self-service",
       "templateListPage.subtitle": "Créer de nouveaux composants logiciels à l'aide de modèles standard dans votre organisation",
-      "templateListPage.pageTitle": "Créer un nouveau composant",
+      "templateListPage.pageTitle": "Self-service",
       "templateListPage.templateGroups.defaultTitle": "Modèles",
       "templateListPage.templateGroups.otherTitle": "Autres modèles",
-      "templateListPage.contentHeader.registerExistingButtonTitle": "Enregistrer un composant existant",
+     "templateListPage.contentHeader.registerExistingButtonTitle": "Importer un dépôt Git existant",
       "templateListPage.contentHeader.supportButtonTitle": "Créer de nouveaux composants logiciels à l'aide de modèles standard. Différents modèles créent différents types de composants (services, sites Web, documentation, ...).",
       "templateListPage.additionalLinksForEntity.viewTechDocsTitle": "Voir TechDocs",
-      "templateWizardPage.title": "Créer un nouveau composant",
+      "templateWizardPage.title": "Self-service",
       "templateWizardPage.subtitle": "Créer de nouveaux composants logiciels à l'aide de modèles standard dans votre organisation",
-      "templateWizardPage.pageTitle": "Créer un nouveau composant",
+      "templateWizardPage.pageTitle": "Self-service",
       "templateWizardPage.pageContextMenu.editConfigurationTitle": "Modifier la configuration",
       "templateEditorToolbar.customFieldExplorerTooltip": "Explorateur de champs personnalisés",
       "templateEditorToolbar.installedActionsDocumentationTooltip": "Documentation des actions installées",
@@ -585,7 +585,7 @@
   "catalog": {
     "fr": {
       "indexPage.title": "Catalogue {{orgName}}",
-      "indexPage.createButtonTitle": "Créer",
+      "indexPage.createButtonTitle": "Self-service",
       "indexPage.supportButtonContent": "Toutes les entités de votre catalogue de logiciels",
       "aboutCard.title": "À propos",
       "aboutCard.refreshButtonTitle": "Actualisation de l'entité de planification",

diff --git a/translations/backstage-it.json b/translations/backstage-it.json
@@ -60,10 +60,10 @@
   "catalog-import": {
     "it": {
       "buttons.back": "Indietro",
-      "defaultImportPage.headerTitle": "Registra un componente esistente",
+      "defaultImportPage.headerTitle": "Importa un repository Git esistente",
       "defaultImportPage.contentHeaderTitle": "Inizia a monitorare il tuo componente in {{appTitle}}",
       "defaultImportPage.supportTitle": "Inizia a monitorare il tuo componente in {{appTitle}} aggiungendolo al catalogo software.",
-      "importInfoCard.title": "Registra un componente esistente",
+      "importInfoCard.title": "Importa un repository Git esistente",
       "importInfoCard.deepLinkTitle": "Scopri di più sul catalogo software",
       "importInfoCard.linkDescription": "Inserisci l'URL del tuo repository del codice sorgente per aggiungerlo a {{appTitle}}.",
       "importInfoCard.fileLinkTitle": "Collegamento a un file di entità esistente",
@@ -469,17 +469,17 @@
       "templateEditorPage.templateEditorTextArea.refreshIconTooltip": "Ricarica file",
       "templateEditorPage.templateEditorTextArea.emptyStateParagraph": "Seleziona un'azione nel menu file.",
       "templateEditorPage.templateFormPreviewer.title": "Carica modello esistente",
-      "templateListPage.title": "Crea un nuovo componente",
+      "templateListPage.title": "Self-service",
       "templateListPage.subtitle": "Crea nuovi componenti software utilizzando modelli standard nella tua organizzazione",
-      "templateListPage.pageTitle": "Crea un nuovo componente",
+      "templateListPage.pageTitle": "Self-service",
       "templateListPage.templateGroups.defaultTitle": "Modelli",
       "templateListPage.templateGroups.otherTitle": "Altri modelli",
-      "templateListPage.contentHeader.registerExistingButtonTitle": "Registra componente esistente",
+      "templateListPage.contentHeader.registerExistingButtonTitle": "Importa un repository Git esistente",
       "templateListPage.contentHeader.supportButtonTitle": "Crea nuovi componenti software utilizzando modelli standard. Modelli diversi creano tipi diversi di componenti (servizi, siti web, documentazione, ...).",
       "templateListPage.additionalLinksForEntity.viewTechDocsTitle": "Visualizza TechDocs",
-      "templateWizardPage.title": "Crea un nuovo componente",
+      "templateWizardPage.title": "Self-service",
       "templateWizardPage.subtitle": "Crea nuovi componenti software utilizzando modelli standard nella tua organizzazione",
-      "templateWizardPage.pageTitle": "Crea un nuovo componente",
+      "templateWizardPage.pageTitle": "Self-service",
       "templateWizardPage.pageContextMenu.editConfigurationTitle": "Modifica configurazione",
       "templateEditorToolbar.customFieldExplorerTooltip": "Esplora campi personalizzati",
       "templateEditorToolbar.installedActionsDocumentationTooltip": "Documentazione delle azioni installate",
@@ -585,7 +585,7 @@
   "catalog": {
     "it": {
       "indexPage.title": "Catalogo {{orgName}}",
-      "indexPage.createButtonTitle": "Crea",
+      "indexPage.createButtonTitle": "Self-service",
       "indexPage.supportButtonContent": "Tutte le entità del catalogo software",
       "aboutCard.title": "Informazioni",
       "aboutCard.refreshButtonTitle": "Pianifica aggiornamento entità",

diff --git a/translations/backstage-ja.json b/translations/backstage-ja.json
@@ -60,10 +60,10 @@
   "catalog-import": {
     "ja": {
       "buttons.back": "戻る",
-      "defaultImportPage.headerTitle": "既存のコンポーネントの登録",
+      "defaultImportPage.headerTitle": "既存の Git リポジトリーのインポート",
       "defaultImportPage.contentHeaderTitle": "{{appTitle}} でのコンポーネントの追跡開始",
       "defaultImportPage.supportTitle": "{{appTitle}} でコンポーネントの追跡を開始するには、コンポーネントをソフトウェアカタログに追加してください。",
-      "importInfoCard.title": "既存のコンポーネントの登録",
+      "importInfoCard.title": "既存の Git リポジトリーのインポート",
       "importInfoCard.deepLinkTitle": "ソフトウェアカタログの詳細",
       "importInfoCard.linkDescription": "{{appTitle}} に追加するソースコードリポジトリーの URL を入力してください。",
       "importInfoCard.fileLinkTitle": "既存のエンティティーファイルへのリンク",
@@ -469,17 +469,17 @@
       "templateEditorPage.templateEditorTextArea.refreshIconTooltip": "ファイルを再読み込みする",
       "templateEditorPage.templateEditorTextArea.emptyStateParagraph": "ファイルメニューでアクションを選択してください。",
       "templateEditorPage.templateFormPreviewer.title": "既存のテンプレートの読み込み",
-      "templateListPage.title": "新しいコンポーネントの作成",
+      "templateListPage.title": "セルフサービス",
       "templateListPage.subtitle": "組織内の標準テンプレートを使用して新しいソフトウェアコンポーネントを作成する",
-      "templateListPage.pageTitle": "新しいコンポーネントの作成",
+      "templateListPage.pageTitle": "セルフサービス",
       "templateListPage.templateGroups.defaultTitle": "テンプレート",
       "templateListPage.templateGroups.otherTitle": "その他のテンプレート",
-      "templateListPage.contentHeader.registerExistingButtonTitle": "既存のコンポーネントの登録",
+      "templateListPage.contentHeader.registerExistingButtonTitle": "既存の Git リポジトリーのインポート",
       "templateListPage.contentHeader.supportButtonTitle": "標準テンプレートを使用して新しいソフトウェアコンポーネントを作成します。テンプレートごとに異なる種類のコンポーネント (サービス、Web サイト、ドキュメント...) が作成されます。",
       "templateListPage.additionalLinksForEntity.viewTechDocsTitle": "TechDocs の表示",
-      "templateWizardPage.title": "新しいコンポーネントの作成",
+      "templateWizardPage.title": "セルフサービス",
       "templateWizardPage.subtitle": "組織内の標準テンプレートを使用して新しいソフトウェアコンポーネントを作成する",
-      "templateWizardPage.pageTitle": "新しいコンポーネントの作成",
+      "templateWizardPage.pageTitle": "セルフサービス",
       "templateWizardPage.pageContextMenu.editConfigurationTitle": "設定の編集",
       "templateEditorToolbar.customFieldExplorerTooltip": "カスタムフィールドエクスプローラー",
       "templateEditorToolbar.installedActionsDocumentationTooltip": "インストール済みアクションのドキュメント",
@@ -585,7 +585,7 @@
   "catalog": {
     "ja": {
       "indexPage.title": "{{orgName}} のカタログ",
-      "indexPage.createButtonTitle": "作成",
+      "indexPage.createButtonTitle": "セルフサービス",
       "indexPage.supportButtonContent": "すべてのソフトウェアカタログエンティティー",
       "aboutCard.title": "概要",
       "aboutCard.refreshButtonTitle": "エンティティー更新のスケジューリング",