From d471817cc72f27776f7115b90fbbfeb02f229efc Mon Sep 17 00:00:00 2001
From: Pepe Cano <825430+ppcano@users.noreply.github.com>
Date: Tue, 23 Sep 2025 10:29:02 +0200
Subject: [PATCH] ui(alerting): Update "Enter custom fieldName" placeholder
 (#109665)

* ui(alerting): Update custom template placeholder

* Use i18n unescape format, instead of JS unescape fn

* Run `make i18n-extract`

* edit code comment
---
 .../receivers/form/fields/TemplateSelector.tsx     | 14 +++++++++++++-
 public/locales/en-US/grafana.json                  |  4 +++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/public/app/features/alerting/unified/components/receivers/form/fields/TemplateSelector.tsx b/public/app/features/alerting/unified/components/receivers/form/fields/TemplateSelector.tsx
index 2af4f973bed..76dbd89b9e2 100644
--- a/public/app/features/alerting/unified/components/receivers/form/fields/TemplateSelector.tsx
+++ b/public/app/features/alerting/unified/components/receivers/form/fields/TemplateSelector.tsx
@@ -303,7 +303,19 @@ function OptionCustomfield({
       <TextArea
         id={id}
         label={t('alerting.option-customfield.label-custom-template', 'Custom template')}
-        placeholder={option.placeholder}
+        placeholder={
+          option.placeholder
+            ? t(
+                'alerting.option-customfield.placeholder-with-template',
+                'Enter plain text or reference a template, e.g. {{- currentTemplate}}',
+                { currentTemplate: option.placeholder }
+              )
+            : // if "option.placeholder" is not set, the placeholder displays the "default.message" template
+              t(
+                'alerting.option-customfield.placeholder',
+                'Enter plain text or reference a template, e.g. {{template "default.message" .}}'
+              )
+        }
         onChange={(e) => onCustomTemplateChange(e.currentTarget.value)}
         defaultValue={initialValue}
       />
diff --git a/public/locales/en-US/grafana.json b/public/locales/en-US/grafana.json
index b34899bbd62..25264087c5f 100644
--- a/public/locales/en-US/grafana.json
+++ b/public/locales/en-US/grafana.json
@@ -2039,7 +2039,9 @@
       "recipient-notification-fires": "Select who should receive a notification when an alert rule fires."
     },
     "option-customfield": {
-      "label-custom-template": "Custom template"
+      "label-custom-template": "Custom template",
+      "placeholder": "Enter plain text or reference a template, e.g. {{template \"default.message\" .}}",
+      "placeholder-with-template": "Enter plain text or reference a template, e.g. {{- currentTemplate}}"
     },
     "other-alert-managers-available": {
       "body-selected-alertmanager-not-found": "The selected Alertmanager no longer exists or you may not have permission to access it. You can select a different Alertmanager from the dropdown.",