diff --git a/docs/reference/zmodel/function.md b/docs/reference/zmodel/function.md
index 1ec2ba4d..545492fd 100644
--- a/docs/reference/zmodel/function.md
+++ b/docs/reference/zmodel/function.md
@@ -109,7 +109,8 @@ Generates a unique identifier based on the [CUID](https://github.com/ericelliott
 
 *Parameters:*
 
-- `version` (optional): The CUID version to generate. Supported values are `1` (default) and `2`.
+- `version` (optional): The CUID version to generate. Supported values are `1` (default) and `2`.<br />
+The NPM package for **CUID v1 is deprecated**, so you should use `2` for all new projects.
 - `format` (optional): A pattern to control the output format. `%s` in the pattern will be replaced by the generated id. Use escaped `\\%s` to have a literal `%s` in the output.
 
 ### nanoid()