PUBSUB-S...CHANNELS(3valkey)

💖 PUBSUB-SHARDCHANNELS 💖

okay bestie, welcome to the Valkey Command Manual — this one's pubsub-shardchannels, page (3valkey), and it's genuinely so simple you're gonna eat 💅

---

✨ NAME ✨

pubsub-shardchannels — Returns the active shard channels.

🌸 SYNOPSIS 🌸

PUBSUB SHARDCHANNELS [pattern]

🦋 DESCRIPTION 🦋

So basically it lists the currently active shard channels. That's it, that's the whole vibe. 🫶

An active shard channel is a Pub/Sub shard channel with one or more subscribers. No subscribers? Not active. Not on the list. It's giving "if you don't show up, you don't get mentioned." 😭

If no pattern is specified, all the channels are listed. But if pattern is specified, only channels matching that specified glob-style pattern get listed. Iconic filtering behaviour, no cap. ✨

lowkey important: the info returned about the active shard channels is at the shard level and not at the cluster level. Remember that. It matters. 👑

💌 REPLY 💌

valkey-protocol(7) Array reply: a list of active channels, optionally matching the specified pattern.

🔥 COMPLEXITY 🔥

O(N) where N is the number of active shard channels, and assuming constant time pattern matching (relatively short shard channels). Fast. Snappy. Main character energy. ⭐

🎀 ACL CATEGORIES 🎀

• @pubsub
• @slow

👑 HISTORY 👑

• Available since: 7.0.0

🌈 EXAMPLES 🌈

> PUBSUB SHARDCHANNELS
1) "orders"
> PUBSUB SHARDCHANNELS o*
1) "orders"

look at that. clean. orders showed up both times because it's literally that girl. 💅

💜 SEE ALSO 💜

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

---

okay that's the whole page, you understood all of it, slay 🎀

Valkey version 9.0.0, dated 2025-10-21 — mwah, bye bestie, go check your shard channels 💖✨🦋