diff --git a/docs/glossary.md b/docs/glossary.md
index c7d64e2e34..905ee11a18 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -185,8 +185,11 @@ mise supports multiple backends for installing tools from different sources:
 
 ## Other Terms
 
-**Aliases**
-: Alternative names for tool versions, allowing shortcuts like `lts` for Node.js LTS versions. See [Tool Aliases](/dev-tools/aliases).
+**Tool Aliases**
+: Alternative names for tool backends or tool versions, managed via `mise tool-alias` or the `[tool_alias]` config section. Backend aliases let a short name like `node` point to a custom backend. Version aliases let symbolic names like `lts-iron` map to a concrete version number. See [Tool Aliases](/dev-tools/aliases).
+
+**Shell Aliases**
+: Shell command aliases (example: `ll = "ls -la"`) managed via `mise shell-alias` or the `[shell_alias]` config section. They are set dynamically when entering a directory and unset when leaving it, similar to environment variables. Supported in bash, zsh, fish, and xonsh. See [Shell Aliases](/shell-aliases).
 
 **direnv**
 : An external tool for environment management that mise can work alongside. See [direnv integration](/direnv).