SUNSUBSCRIBE(3valkey)

💖 SUNSUBSCRIBE 💖

okay bestie, welcome to the Valkey Command Manual — this one lives in section 3valkey and it's literally the "bye shard channels" button 💅

---

✨ NAME ✨

sunsubscribe — stops listening to messages posted to shard channels.

no cap. that's the whole vibe. you subscribed, now you're un-subscribing 🦋

---

🌸 SYNOPSIS 🌸

SUNSUBSCRIBE shardchannel [shardchannel...]

---

🎀 DESCRIPTION 🎀

so here's the tea, bestie: this unsubscribes the client from the shard channels you name, or from all of them if you name none at all. main character energy either way 👑

When no shard channels are specified, the client is unsubscribed from all the previously subscribed shard channels. And in that case? A message for every unsubscribed shard channel gets sent to the client. like, one lil goodbye note each 🥺

Note: the global channels and shard channels need to be unsubscribed from separately. they are not the same thing, they do not share a vibe, do not try to two-for-one this 🙈

For more info about sharded Pub/Sub, go check out valkey-pubsub(7) Sharded Pub/Sub. iykyk 📚

---

💌 REPLY 💌

When it works, this command doesn't return anything. nothing. silence. iconic.

Instead — for each shard channel — one message is pushed where the first element is the string sunsubscribe. that's your confirmation that the command succeeded. it's giving receipt 🧾✨

---

🔥 COMPLEXITY 🔥

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

---

👑 ACL CATEGORIES 👑

• @pubsub
• @slow

---

🌈 HISTORY 🌈

• Available since: 7.0.0 ⭐

---

🫶 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)
• unsubscribe(3valkey)

---

okay that's the whole page, no crumbs left 🍓 this was Valkey 9.0.0, dated 2025-10-21 — go unsubscribe from something, bestie, and hydrate while you're at it 💖🧚