diff --git a/doc/api/cli.md b/doc/api/cli.md
index f4c87b8276728d..56dfa19d3f8b98 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -501,6 +501,15 @@ $ ls *.cpuprofile
 CPU.20190409.202950.15293.0.0.cpuprofile
 ```
 
+If `--cpu-prof-name` is specified, the provided value will be used as-is; patterns such as
+`${hhmmss}` or `${pid}` are not supported.
+
+```console
+$ node --cpu-prof --cpu-prof-name 'CPU.${pid}.cpuprofile' index.js
+$ ls *.cpuprofile
+'CPU.${pid}.cpuprofile'
+```
+
 ### `--cpu-prof-dir`
 
 <!-- YAML