diff --git a/docs/3-create-a-zarf-package/4-zarf-schema.md b/docs/3-create-a-zarf-package/4-zarf-schema.md
index 8962ec9fc6..496a6ac74f 100644
--- a/docs/3-create-a-zarf-package/4-zarf-schema.md
+++ b/docs/3-create-a-zarf-package/4-zarf-schema.md
@@ -611,12 +611,12 @@ must respect the following conditions
 
 <details>
 <summary>
-<strong> <a name="components_items_required"></a>required</strong>
+<strong> <a name="components_items_optional"></a>optional</strong>
 </summary>
 &nbsp;
 <blockquote>
 
-**Description:** Do not prompt user to install this component
+**Description:** Prompt user to install this component on package deploy
 
 |          |           |
 | -------- | --------- |
diff --git a/zarf.schema.json b/zarf.schema.json
index d849c1b39a..e91f979387 100644
--- a/zarf.schema.json
+++ b/zarf.schema.json
@@ -225,7 +225,11 @@
         },
         "required": {
           "type": "boolean",
-          "description": "Do not prompt user to install this component"
+          "description": "[Deprecated] Do not prompt user to install this component"
+        },
+        "optional": {
+          "type": "boolean",
+          "description": "Prompt user to install this component on package deploy"
         },
         "only": {
           "$schema": "http://json-schema.org/draft-04/schema#",