From d96a8842267884230b2a9220047472527a870ac4 Mon Sep 17 00:00:00 2001
From: Owen <owen@txv.io>
Date: Thu, 23 Apr 2026 12:25:29 -0700
Subject: [PATCH] Add site callout

---
 manage/blueprints.mdx | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/manage/blueprints.mdx b/manage/blueprints.mdx
index 2401e47..db1c03d 100644
--- a/manage/blueprints.mdx
+++ b/manage/blueprints.mdx
@@ -179,6 +179,10 @@ public-resources:
         method: http
 ```
 
+<Note>
+When applying a blueprint via Newt (using `--blueprint-file` or container labels), `site` on each target is optional. If omitted, the target is assigned to the site of the Newt that applied the blueprint.
+</Note>
+
 ### Raw TCP Or UDP Example
 
 ```yaml
@@ -279,6 +283,10 @@ Private resources define what Pangolin clients can reach after they connect to y
 - Use **`mode: host`** for a single host or DNS name
 - Use **`mode: cidr`** for an entire network range
 
+<Note>
+When applying a blueprint via Newt (using `--blueprint-file` or container labels), `site` is optional. If omitted, the resource is assigned to the site of the Newt that applied the blueprint.
+</Note>
+
 ```yaml
 private-resources:
   internal-net:
@@ -397,7 +405,7 @@ This creates a single Pangolin resource with multiple targets:
 </Card>
 
 <Card title="Site Assignment">
-  If no `site` is specified, the resource is assigned to the Newt site that discovered the container.
+  If no `site` is specified on a target (public resource) or on a private resource, it is assigned to the site of the Newt that applied the blueprint — whether through container labels or `--blueprint-file`.
 </Card>
 
 <Card title="Merged Configuration">
@@ -782,7 +790,7 @@ public-resources:
 
         <Expandable title="Target object">
           <ResponseField name="site" type="string">
-            Site that hosts the target.
+            Site that hosts the target. Optional when deploying from a Newt — if omitted, the target is assigned to the site of the Newt that applied the blueprint.
 
             YAML: `site: my-site`  
             Container label: `pangolin.public-resources.web-app.targets[0].site=my-site`
@@ -993,8 +1001,8 @@ private-resources:
         Container label: `pangolin.private-resources.internal-net.mode=cidr`
       </ResponseField>
 
-      <ResponseField name="site" type="string" required>
-        Site that hosts the resource.
+      <ResponseField name="site" type="string">
+        Site that hosts the resource. Optional when deploying from a Newt — if omitted, the resource is assigned to the site of the Newt that applied the blueprint.
 
         YAML: `site: my-site`  
         Container label: `pangolin.private-resources.internal-net.site=my-site`