PUBSUB-NUMPAT(3valkey)

✨ PUBSUB-NUMPAT 💅

okay bestie, welcome to the Valkey Command Manual page for pubsub-numpat — yes, it's a (3valkey) situation, we're fancy like that 🎀

---

🌸 NAME 🌸

pubsub-numpat — counts up all the unique pattern subscriptions for you. that's the whole job. it's giving "one thing, done perfectly" 👑

---

🦋 SYNOPSIS 🦋

PUBSUB NUMPAT

literally that's it. no arguments, no drama, no options. iconic behavior fr fr ✨

---

💖 DESCRIPTION 💖

so it returns the number of unique patterns that clients are subscribed to — and those subscriptions happen via the valkey-psubscribe(7) PSUBSCRIBE command, iykyk 🧚

⚠️ and listen, because this trips people up: this is NOT the count of clients subscribed to patterns. nope. it's the total number of unique patterns that all the clients are subscribed to. so if a hundred besties all subscribe to the same pattern, that's still just one pattern. periodt 💅

Cluster note: in a Valkey Cluster, clients can subscribe to every node, and can also publish to every other node too. the cluster will make sure that published messages get forwarded wherever they need to go 🌈 that said — and this is the important bit — the replies from valkey-pubsub(7) PUBSUB in a cluster only report information from the node's own Pub/Sub context, not the entire cluster. so don't come for the numbers expecting the whole cluster's tea, because you will not get it 😭

---

🎀 REPLY 🎀

valkey-protocol(7) Integer reply: the number of patterns all the clients are subscribed to. a nice clean integer, no crumbs 🍓

---

🔥 COMPLEXITY 🔥

O(1)

constant time, always. fastest girl in the room, no cap ⭐

---

👑 ACL CATEGORIES 👑

@pubsub @slow

---

🌈 HISTORY 🌈

• Available since: 2.8.0

she's been here since 2.8.0 and she's been serving ever since 💜

---

💀 SEE ALSO 💀

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

---

and that's the whole page bestie 🫶 go count those patterns, stay hydrated, and remember: it's unique patterns, not unique clients, and in a cluster you only see your own node's business 🙈

this has been the Valkey Command Manual, version 9.0.0, dated 2025-10-21 — mwah 💖