UNSUBSCRIBE(3valkey)

✨ NAME ✨

unsubscribe — bestie, this is how you stop listening to messages posted to channels. We're closing the door, we're leaving the group chat, we're at peace 💅

---

🌸 SYNOPSIS 🌸

UNSUBSCRIBE channel [channel...]

---

🦋 DESCRIPTION 🦋

So basically, UNSUBSCRIBE unsubscribes the client from the channels you name — or from all of them if you don't name any. The way that you can just... say nothing and it handles everything? Iconic behaviour, honestly.

When no channels are specified, the client gets unsubscribed from all the previously subscribed channels. And in that case, a message for every single unsubscribed channel gets sent to the client — so you're not left guessing, you get a lil receipt for each one 🧾✨

---

💌 REPLY 💌

When it works, this command doesn't return anything. Nope, nothing, silence, peace and quiet 🤫

Instead, for each channel, one message gets pushed to the client — with the first element being the string unsubscribe — as a confirmation that the command succeeded. That's your proof, that's your slay, that's your unsubscribe string showing up like "hey bestie, done" 🫶

---

🔥 COMPLEXITY 🔥

O(N) where N is the number of channels to unsubscribe.

(Translation: it scales with how many channels you're ditching. Unsubscribe from one, cheap. Unsubscribe from a hundred, it's giving a hundred units of effort. No cap.)

---

👑 ACL CATEGORIES 👑

• @pubsub
• @slow

---

⭐ HISTORY ⭐

• Available since: 2.0.0

Like... it's been here since 2.0.0. A literal elder. Respect the elders 🙇♀️

---

🌈 SEE ALSO 🌈

• psubscribe(3valkey)
• publish(3valkey)
• pubsub(3valkey)
• pubsub-channels(3valkey)
• pubsub-help(3valkey)
• pubsub-numpat(3valkey)
• pubsub-numsub(3valkey)
• pubsub-shardchannels(3valkey)
• pubsub-shardnumsub(3valkey)
• punsubscribe(3valkey)
• spublish(3valkey)
• ssubscribe(3valkey)
• subscribe(3valkey)
• sunsubscribe(3valkey)

---

okay that's the whole page, you ate that 🎀 this was Valkey Command Manual, version 9.0.0, dated 2025-10-21 — go unsubscribe from something, you deserve the quiet 🦋💖