This means Redis does not recognise the command you sent, usually a typo or a command your server version or modules do not provide. Correcting or enabling the command resolves it. Jump to your situation below or work through the methods in order.
By Neeraj Singh ~6 min Updated Jun 2026 88% found this helpful
Error message
ERR unknown command 'xxx', with args beginning with: ...
Summary
The Redis ERR unknown command error means the server does not recognise the command you sent. The common causes are a typo or wrong argument shape, a newer command run against an older Redis that does not support it, or a command that belongs to a module (such as JSON, Search or Bloom filters) that is not loaded. The error helpfully echoes the command name and the first arguments, which usually pinpoints the mistake. The fix is to verify the command spelling and syntax against the official Redis command reference, upgrade Redis if the command was added in a later version, and load the required module if the command comes from one. Confirming the server version with INFO server tells you whether the command should exist at all.
What this error means
Redis parses the first word of your request as the command name. ERR unknown command means that word does not match any command the running server knows, so it cannot dispatch it. The echoed name and arguments show exactly what it received.
That mismatch is either your text (a typo or wrong syntax) or the server's capabilities (an older version, or a missing module that would add the command). Checking the docs fixes the first; checking the version and loaded modules fixes the second.
Common causes
A typo or wrong command name.
A command added in a newer Redis version.
A module command with the module not loaded.
Wrong argument shape parsed as part of the name.
Connected to the wrong server or a compatibility layer.
Expert insight
“ERR unknown command is Redis not recognising the first word you sent. Helpfully it echoes that word back, so step one is just reading it, usually it is a typo. If the spelling is right, then it is a capability gap: either the command is newer than your server, so you upgrade, or it belongs to a module like RedisJSON that is not loaded, so you load the module. A quick INFO server tells you the version and settles whether the command should even exist.”
Manager, Tech Support & Operations · 19+ years fixing Windows and system errors
✓ How to fix it
Method 1
Verify the spelling and syntax
1Check the command and its arguments against the official Redis command reference.
2Watch for typos and a wrong argument order that gets parsed as the command name.
3Correct and retry.
Method 2
Confirm the server version
1Check what version you are running:
INFO server
2Compare it against the version that introduced the command.
3An older server simply will not have a newer command.
Method 3
Upgrade Redis if the command is newer
1If the command was added in a later release, upgrade the Redis server.
2Then the command becomes available.
3Test after upgrading.
Method 4
Load the required module
1If the command comes from a module (JSON, Search, Bloom), load that module.
2Check loaded modules:
MODULE LIST
3Add the module via redis.conf or MODULE LOAD.
ERR unknown command means Redis does not recognise the command. Read the echoed name, it is usually a typo, then verify spelling against the docs. If the spelling is right, the command may be newer than your server (upgrade) or belong to a module (load it). INFO server confirms the version.
Frequently asked questions
What does ERR unknown command mean in Redis?
It means the server does not recognise the command you sent. It echoes the command name and first arguments, which usually points to a typo, an unsupported version, or a missing module.
How do I fix it?
Verify the command spelling and syntax against the Redis command reference, confirm your server version with INFO server, upgrade Redis if the command is newer, and load the module if it belongs to one.
Why would a valid command be unknown?
Because the running server is older than the version that added it, or the command comes from a module (such as RedisJSON or RediSearch) that is not loaded on your instance.
How do I check my Redis version?
Run INFO server and read the redis_version field. Compare it against the version that introduced the command to see whether it should be available.
How do I load a module?
Add the module in redis.conf with a loadmodule directive, or load it at runtime with MODULE LOAD. Confirm with MODULE LIST that it is loaded.
Could the arguments cause this?
Yes. A wrong argument order or shape can make Redis parse the wrong token as the command name. Recheck the syntax against the docs and fix the argument layout.
Still not working?
If the command is spelled correctly and your version supports it but it is still unknown, you may be connected through a proxy or a managed-Redis layer that disables certain commands; check the provider's command-restriction list. You can also submit your error to us for a tailored fix.