diff --git a/plugins/enapter/skills/blueprint-creator/references/manifest/gotchas.md b/plugins/enapter/skills/blueprint-creator/references/manifest/gotchas.md
index 83d54ec..9028d95 100644
--- a/plugins/enapter/skills/blueprint-creator/references/manifest/gotchas.md
+++ b/plugins/enapter/skills/blueprint-creator/references/manifest/gotchas.md
@@ -12,7 +12,7 @@ If the device has operational states (e.g. `idle`, `running`, `fault`), encode t
 
 - `alerts` field in telemetry: this field is automatically added during manifest compilation.
 - `lua_api_ver_3` to `requirements`
-- `vendor`
+- top-level `vendor:` metadata field (e.g. `vendor: sma` at the same level as `display_name:`). This is the blueprint-level vendor tag, distinct from `properties.vendor` which is a perfectly valid property declaration for exposing the device vendor as readable telemetry.
 
 ## List all alerts