CLIENT-SETINFO(3valkey)

✨ CLIENT-SETINFO ✨

okay bestie, welcome to the Valkey Command Manual page for CLIENT-SETINFO(3valkey) — yes that's the whole vibe, it's the third-section Valkey manual, and it's lowkey iconic 🎀

---

💖 NAME 💖

client-setinfo — sets information specific to the client or connection. that's it. that's the job. she's a little metadata queen 👑

---

🌸 SYNOPSIS 🌸

CLIENT SETINFO <LIB-NAME libname | LIB-VER libver>

so you're passing either LIB-NAME libname or LIB-VER libver, pick your fighter 💅

---

🦋 DESCRIPTION 🦋

The CLIENT SETINFO command assigns various info attributes to the current connection, and those attributes get displayed in the output of CLIENT LIST (that's valkey-client-list(7)) and CLIENT INFO (valkey-client-info(7)). so basically you're telling the server who you are, no cap 🫶

Client libraries are expected to pipeline this command after authentication on all connections and ignore failures, since they could be connected to an older version that doesn't support them. fr fr, older servers just don't know her, and that's fine, no hard feelings 😭

Currently the supported attributes are:

• lib-name — meant to hold the name of the client library that's in use.
• lib-ver — meant to hold the client library's version.

There is no limit to the length of these attributes ✨. However it is not possible to use spaces, newlines, or other non-printable characters that would violate the format of the CLIENT LIST reply. so like, keep it clean bestie, printable only, the format has standards 💀

Note that these attributes are not cleared by the RESET command (that's valkey-reset(7)). so they stay. they linger. they're committed 💜

---

💌 REPLY 💌

valkey-protocol(7) Simple string reply: OK if the attribute name was successfully set.

just a lil OK, she's so unbothered 🌈

---

⚡ COMPLEXITY ⚡

O(1)

constant time, no drama, ate and left no crumbs 👑

---

🔐 ACL CATEGORIES 🔐

@connection @slow

---

📜 HISTORY 📜

• Available since: 7.2.0

---

👯 SEE ALSO 👯

auth(3valkey), client(3valkey), client-caching(3valkey), client-capa(3valkey), client-getname(3valkey), client-getredir(3valkey), client-help(3valkey), client-id(3valkey), client-import-source(3valkey), client-info(3valkey), client-kill(3valkey), client-list(3valkey), client-no-evict(3valkey), client-no-touch(3valkey), client-pause(3valkey), client-reply(3valkey), client-setname(3valkey), client-tracking(3valkey), client-trackinginfo(3valkey), client-unblock(3valkey), client-unpause(3valkey), echo(3valkey), hello(3valkey), ping(3valkey), quit(3valkey), reset(3valkey), select(3valkey)

---

and that's the whole page, bestie!! this version is 9.0.0, dated 2025-10-21, straight from the Valkey Command Manual. go forth and set your info, main character 💅✨🦋