From 646cbadb9d7aead4b4ee428c27a932e24f9b9124 Mon Sep 17 00:00:00 2001
From: Toby Griffiths <toby@cubicmushroom.co.uk>
Date: Fri, 10 Jul 2026 17:35:05 +0100
Subject: [PATCH] Add missing tasks.{task}.vars to schema reference

Add documentation for task level vars in schema.
---
 website/src/docs/reference/schema.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/website/src/docs/reference/schema.md b/website/src/docs/reference/schema.md
index 71ead0757e..4358ef0be3 100644
--- a/website/src/docs/reference/schema.md
+++ b/website/src/docs/reference/schema.md
@@ -735,6 +735,24 @@ tasks:
             ref: .ALLOWED_ENVS
     cmds:
       - ./deploy.sh
+
+#### [`vars`](#variable)
+
+- **Type**: `map[string]Variable`
+- **Description**: Task level variables available to individual task
+
+```yaml
+tasks:
+  default:
+    vars:
+      # Simple values
+      APP_NAME: myapp
+      VERSION: 1.0.0
+      DEBUG: true
+      PORT: 8080
+      FEATURES: [auth, logging]
+  cmds:
+    # …
 ```
 
 See [Prompting for missing variables interactively](/docs/guide#prompting-for-missing-variables-interactively)