diff --git a/docs/docs/20-usage/20-pipeline-syntax.md b/docs/docs/20-usage/20-pipeline-syntax.md
index 2db15f0b4..1d9fb32aa 100644
--- a/docs/docs/20-usage/20-pipeline-syntax.md
+++ b/docs/docs/20-usage/20-pipeline-syntax.md
@@ -376,11 +376,13 @@ when:
 
 #### `tag`
 
-Execute a step if the tag name starts with `release`:
+This filter only applies to tag events.
+Use glob expression to execute a step if the tag name starts with `v`:
 
 ```diff
 when:
-  tag: release*
+  event: tag
+  tag: v*
 ```
 
 #### `status`