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
```
+
+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.
+
+
### 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
+
+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.
+
+
```yaml
private-resources:
internal-net:
@@ -397,7 +405,7 @@ This creates a single Pangolin resource with multiple targets:
- 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`.
@@ -782,7 +790,7 @@ public-resources:
- 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`
-
- Site that hosts the resource.
+
+ 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`