[GH-ISSUE #1580] Support un-subscribing to a topic via a ntfy:// link #1110

Open
opened 2026-05-07 00:30:20 +02:00 by BreizhHardware · 0 comments

Originally created by @therden on GitHub (Jan 30, 2026).
Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/1580

💡 Idea
As covered here in the documentation: when using an Android device on which the ntfy client is already installed, clicking on a well-formed "ntfy:// link" in the form ntfy://<host>/<topic>?display=<name> will open the client and subscribe the user to the specified topic and assign a display name for that topic. This feature assists would-be subscribers in circumstances where the actual topic name may present a challenge to enter accurately and/or the true name gives no hint about the topic's contents -- when the topic name is a UUID, for example.

I'm writing to ask that you consider adding another link type that, when clicked, would open the client app to unsubscribe to the specified topic -- possibly taking the form ntfy://<host>/<topic>?unsubscribe=true.

I realize that users can easily unsubscribe to any topic manually within the app; but when the initial subscription was automated via a "ntfy:// link`, it'd be nice to be able to provide a link to likewise automate the un-subscribe process.

💻 Target components
Android client (initially, since it's the only platform that presently supports using "ntfy:// links" to subscribe to a topic.)

Originally created by @therden on GitHub (Jan 30, 2026). Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/1580 :bulb: **Idea** As covered [here](https://docs.ntfy.sh/subscribe/phone/?h=email#ntfy-links) in the documentation: when using an Android device on which the **ntfy** client is already installed, clicking on a well-formed "ntfy:// link" in the form `ntfy://<host>/<topic>?display=<name>` will open the client and subscribe the user to the specified topic and assign a *display name* for that topic. This feature assists would-be subscribers in circumstances where the actual topic name may present a challenge to enter accurately and/or the true name gives no hint about the topic's contents -- when the topic name is a UUID, for example. I'm writing to ask that you consider adding another link type that, when clicked, would open the client app to ***un*subscribe** to the specified topic -- possibly taking the form `ntfy://<host>/<topic>?unsubscribe=true`. I realize that users can easily unsubscribe to any topic manually within the app; but when the initial subscription was automated via a "ntfy:// link`, it'd be nice to be able to provide a link to likewise automate the un-subscribe process. :computer: **Target components** Android client (initially, since it's the only platform that presently supports using "ntfy:// links" to subscribe to a topic.)
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ntfy#1110
No description provided.