From 6f1b3a477a8cabdba8684480ee78f6ee6507e9cd Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Fri, 23 Jan 2026 21:33:55 +0000
Subject: [PATCH 1/2] docs: update --template flag description in CLI reference

- Add explanation of how template strings resolve to GitHub URLs
- Document that users can use their own organization/repository
- Add example for using custom template repositories

Resolves KNO-11348

Co-authored-by: matt <matt@knock.app>
---
 content/__cli/content.mdx | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/content/__cli/content.mdx b/content/__cli/content.mdx
index bcb76c5b2..7081d8f6b 100644
--- a/content/__cli/content.mdx
+++ b/content/__cli/content.mdx
@@ -728,7 +728,7 @@ The command will create a new workflow directory in your local file system. By d
   <Attribute
     name="--template"
     type="string"
-    description="A template to use for scaffolding the workflow. Can be a GitHub repository path (e.g., 'workflows/digest-email')."
+    description="A template to use for scaffolding the workflow. Accepts a template string that resolves to a GitHub repository URL. For example, 'knocklabs/templates/workflows/digest-email' resolves to 'https://github.com/knocklabs/templates/tree/main/workflows/digest-email'. You can use your own organization and repository (e.g., 'your-org/your-repo/workflows/my-workflow')."
   />
   <Attribute
     name="--push"
@@ -757,8 +757,12 @@ knock workflow new --key=my-workflow
 knock workflow new --key=my-workflow --steps=email,sms,in_app_feed
 ```
 
-```bash title="Create a workflow from a template"
-knock workflow new --key=my-workflow --template=workflows/digest-email
+```bash title="Create a workflow from a Knock template"
+knock workflow new --key=my-workflow --template=knocklabs/templates/workflows/digest-email
+```
+
+```bash title="Create a workflow from a custom template repository"
+knock workflow new --key=my-workflow --template=your-org/your-repo/workflows/my-workflow
 ```
 
 ```bash title="Create and push a workflow"

From d26eaec7533d800357e9346dd487bcab7d3281ac Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Fri, 23 Jan 2026 22:20:42 +0000
Subject: [PATCH 2/2] docs: address review feedback on --template flag
 description

- Updated description format per reviewer suggestion
- Restored original example (removed custom template example)
- Added link to pre-built Knock templates

Co-authored-by: matt <matt@knock.app>
---
 content/__cli/content.mdx | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/content/__cli/content.mdx b/content/__cli/content.mdx
index 7081d8f6b..6f1537364 100644
--- a/content/__cli/content.mdx
+++ b/content/__cli/content.mdx
@@ -728,7 +728,7 @@ The command will create a new workflow directory in your local file system. By d
   <Attribute
     name="--template"
     type="string"
-    description="A template to use for scaffolding the workflow. Accepts a template string that resolves to a GitHub repository URL. For example, 'knocklabs/templates/workflows/digest-email' resolves to 'https://github.com/knocklabs/templates/tree/main/workflows/digest-email'. You can use your own organization and repository (e.g., 'your-org/your-repo/workflows/my-workflow')."
+    description="A template to use for scaffolding the workflow. Accepts a template string that resolves to a GitHub repository URL. For example, `<your-org>/<your-repo>/workflows/digest-email`. Use `workflows/<workflow-key>` to reference [pre-built Knock templates](https://github.com/knocklabs/templates/tree/main/workflows)."
   />
   <Attribute
     name="--push"
@@ -757,12 +757,8 @@ knock workflow new --key=my-workflow
 knock workflow new --key=my-workflow --steps=email,sms,in_app_feed
 ```
 
-```bash title="Create a workflow from a Knock template"
-knock workflow new --key=my-workflow --template=knocklabs/templates/workflows/digest-email
-```
-
-```bash title="Create a workflow from a custom template repository"
-knock workflow new --key=my-workflow --template=your-org/your-repo/workflows/my-workflow
+```bash title="Create a workflow from a template"
+knock workflow new --key=my-workflow --template=workflows/digest-email
 ```
 
 ```bash title="Create and push a workflow"