diff --git a/.changeset/tidy-cups-draw.md b/.changeset/tidy-cups-draw.md
new file mode 100644
index 000000000..2001a45e0
--- /dev/null
+++ b/.changeset/tidy-cups-draw.md
@@ -0,0 +1,5 @@
+---
+'@asyncapi/cli': patch
+---
+
+Clarified help text for --param flag usage.
diff --git a/src/apps/cli/internal/flags/generate/sharedFlags.ts b/src/apps/cli/internal/flags/generate/sharedFlags.ts
index b08f5dfc6..c721d102a 100644
--- a/src/apps/cli/internal/flags/generate/sharedFlags.ts
+++ b/src/apps/cli/internal/flags/generate/sharedFlags.ts
@@ -38,7 +38,7 @@ export const sharedFlags = {
   ),
   param: Flags.string({
     char: 'p',
-    description: 'Additional param to pass to templates',
+    description: 'Additional param to pass to templates (e.g., --param sidebarOrganization=byTags)',
     multiple: true
   }),
   'map-base-url': Flags.string({