From bfe4d47a75b0b1b9a0c2138b8c9956330b0189c7 Mon Sep 17 00:00:00 2001
From: Bart de Lange <b.delange@vgz.nl>
Date: Fri, 7 Aug 2026 16:17:16 +0200
Subject: [PATCH 1/3] feat: add support for ntfy.sh tags

---
 docs/using-seerr/notifications/ntfy.md        |  4 ++++
 seerr-api.yml                                 |  2 ++
 server/lib/notifications/agents/ntfy.ts       |  7 +++++++
 server/lib/settings/index.ts                  |  2 ++
 .../Notifications/NotificationsNtfy/index.tsx | 20 +++++++++++++++++++
 5 files changed, 35 insertions(+)

diff --git a/docs/using-seerr/notifications/ntfy.md b/docs/using-seerr/notifications/ntfy.md
index 6aa4664923..4b9fc5c6bb 100644
--- a/docs/using-seerr/notifications/ntfy.md
+++ b/docs/using-seerr/notifications/ntfy.md
@@ -16,6 +16,10 @@ Set this to the URL of your ntfy.sh server.
 
 Set this to the topic you want to send notifications to.
 
+### Tags (optional)
+
+Set this to a comma-separated list of ntfy tags to apply to notifications (for example, `eyes` or `eyes,warning`).
+
 ### Username + Password authentication (optional)
 
 Set this to the username and password for your ntfy.sh server.
diff --git a/seerr-api.yml b/seerr-api.yml
index 4b33bf7892..da5bbb8a92 100644
--- a/seerr-api.yml
+++ b/seerr-api.yml
@@ -1554,6 +1554,8 @@ components:
               type: string
             topic:
               type: string
+            tags:
+              type: string
             authMethodUsernamePassword:
               type: boolean
             username:
diff --git a/server/lib/notifications/agents/ntfy.ts b/server/lib/notifications/agents/ntfy.ts
index fae329a007..c9efcbe2f6 100644
--- a/server/lib/notifications/agents/ntfy.ts
+++ b/server/lib/notifications/agents/ntfy.ts
@@ -35,6 +35,10 @@ class NtfyAgent
     const embedPoster = settings.embedPoster;
 
     const topic = settings.options.topic;
+    const tags = settings.options.tags
+      ?.split(',')
+      .map((tag) => tag.trim())
+      .filter((tag) => tag.length > 0);
     const priority = settings.options.priority ?? 3;
 
     const title = payload.event
@@ -102,6 +106,9 @@ class NtfyAgent
       message,
       markdown: true,
     };
+    if (tags && tags.length > 0) {
+      ntfyPayload.tags = tags;
+    }
     if (attach) {
       ntfyPayload.attach = attach;
     }
diff --git a/server/lib/settings/index.ts b/server/lib/settings/index.ts
index 0a896524eb..9e2538c189 100644
--- a/server/lib/settings/index.ts
+++ b/server/lib/settings/index.ts
@@ -312,6 +312,7 @@ export interface NotificationAgentNtfy extends NotificationAgentConfig {
   options: {
     url: string;
     topic: string;
+    tags?: string;
     authMethodUsernamePassword?: boolean;
     username?: string;
     password?: string;
@@ -563,6 +564,7 @@ class Settings {
             options: {
               url: '',
               topic: '',
+              tags: '',
               priority: 3,
               locale: 'en',
             },
diff --git a/src/components/Settings/Notifications/NotificationsNtfy/index.tsx b/src/components/Settings/Notifications/NotificationsNtfy/index.tsx
index 07f3e84dba..9e8bb2bedf 100644
--- a/src/components/Settings/Notifications/NotificationsNtfy/index.tsx
+++ b/src/components/Settings/Notifications/NotificationsNtfy/index.tsx
@@ -23,6 +23,8 @@ const messages = defineMessages(
     embedPoster: 'Embed Poster',
     url: 'Server root URL',
     topic: 'Topic',
+    tags: 'Tags',
+    tagsPlaceholder: 'eyes,warning',
     usernamePasswordAuth: 'Username + Password authentication',
     username: 'Username',
     password: 'Password',
@@ -100,6 +102,7 @@ const NotificationsNtfy = () => {
         types: data?.types,
         url: data?.options.url,
         topic: data?.options.topic,
+        tags: data?.options.tags ?? '',
         authMethodUsernamePassword: data?.options.authMethodUsernamePassword,
         username: data?.options.username,
         password: data?.options.password,
@@ -118,6 +121,7 @@ const NotificationsNtfy = () => {
             options: {
               url: values.url,
               topic: values.topic,
+              tags: values.tags,
               authMethodUsernamePassword: values.authMethodUsernamePassword,
               username: values.username,
               password: values.password,
@@ -171,6 +175,7 @@ const NotificationsNtfy = () => {
               options: {
                 url: values.url,
                 topic: values.topic,
+                tags: values.tags,
                 authMethodUsernamePassword: values.authMethodUsernamePassword,
                 username: values.username,
                 password: values.password,
@@ -252,6 +257,21 @@ const NotificationsNtfy = () => {
                   )}
               </div>
             </div>
+            <div className="form-row">
+              <label htmlFor="tags" className="text-label">
+                {intl.formatMessage(messages.tags)}
+              </label>
+              <div className="form-input-area">
+                <div className="form-input-field">
+                  <Field
+                    id="tags"
+                    name="tags"
+                    type="text"
+                    placeholder={intl.formatMessage(messages.tagsPlaceholder)}
+                  />
+                </div>
+              </div>
+            </div>
             <div className="form-row">
               <label
                 htmlFor="authMethodUsernamePassword"

From 1c1f1ade0e46d70356a7deca2d866ceefbb129f6 Mon Sep 17 00:00:00 2001
From: bartdelange <bart.de.lange32@gmail.com>
Date: Sat, 8 Aug 2026 15:49:53 +0200
Subject: [PATCH 2/3] style(translation): ran i18n:generate

---
 src/i18n/locale/en.json | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/i18n/locale/en.json b/src/i18n/locale/en.json
index d546f6782a..e9dbfda9c4 100644
--- a/src/i18n/locale/en.json
+++ b/src/i18n/locale/en.json
@@ -660,6 +660,8 @@
   "components.Settings.Notifications.NotificationsNtfy.ntfysettingssaved": "Ntfy notification settings saved successfully!",
   "components.Settings.Notifications.NotificationsNtfy.password": "Password",
   "components.Settings.Notifications.NotificationsNtfy.priority": "Priority",
+  "components.Settings.Notifications.NotificationsNtfy.tags": "Tags",
+  "components.Settings.Notifications.NotificationsNtfy.tagsPlaceholder": "eyes,warning",
   "components.Settings.Notifications.NotificationsNtfy.toastNtfyTestFailed": "Ntfy test notification failed to send.",
   "components.Settings.Notifications.NotificationsNtfy.toastNtfyTestSending": "Sending ntfy test notification…",
   "components.Settings.Notifications.NotificationsNtfy.toastNtfyTestSuccess": "Ntfy test notification sent!",

From 087902336a69c532a745c2a1d6b3f04a2d3071f5 Mon Sep 17 00:00:00 2001
From: Bart de Lange <32978882+bartdelange@users.noreply.github.com>
Date: Mon, 10 Aug 2026 22:20:22 +0200
Subject: [PATCH 3/3] Update docs/using-seerr/notifications/ntfy.md

Co-authored-by: 0xsysr3ll <31414959+0xSysR3ll@users.noreply.github.com>
---
 docs/using-seerr/notifications/ntfy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/using-seerr/notifications/ntfy.md b/docs/using-seerr/notifications/ntfy.md
index 4b9fc5c6bb..2b153a2f94 100644
--- a/docs/using-seerr/notifications/ntfy.md
+++ b/docs/using-seerr/notifications/ntfy.md
@@ -18,7 +18,7 @@ Set this to the topic you want to send notifications to.
 
 ### Tags (optional)
 
-Set this to a comma-separated list of ntfy tags to apply to notifications (for example, `eyes` or `eyes,warning`).
+Set this to a comma-separated list of [ntfy tags](https://docs.ntfy.sh/publish/#tags-emojis) to apply to notifications (for example, `eyes` or `eyes,warning`).
 
 ### Username + Password authentication (optional)