diff --git a/docs/blueprint-designer-guide/blueprint-families.md b/docs/blueprint-designer-guide/blueprint-families.md
index e1100abab..a6c06e898 100644
--- a/docs/blueprint-designer-guide/blueprint-families.md
+++ b/docs/blueprint-designer-guide/blueprint-families.md
@@ -33,7 +33,8 @@ description: A blueprint family
 
 metadata:
   display-name: My App Environments
-  icon: graphics/myicon.png
+  icon: 
+    path: graphics/myicon.png
   self-service: true
   blueprint-labels:
     - key: 'team'
diff --git a/docs/blueprint-designer-guide/blueprints/blueprints-yaml-structure.md b/docs/blueprint-designer-guide/blueprints/blueprints-yaml-structure.md
index 5884dd0ad..969b92760 100644
--- a/docs/blueprint-designer-guide/blueprints/blueprints-yaml-structure.md
+++ b/docs/blueprint-designer-guide/blueprints/blueprints-yaml-structure.md
@@ -798,7 +798,7 @@ metadata:
     path: "graphics/linux.svg"
 ```
 
-Icons are discovered by default under the `graphics` directory.
+Icons are discovered by default under the `graphics` directory. Setting an icon in the metadata does not work for "Stored in Torque" blueprints.
 
 ## Grains inputs & outputs
 Inputs and outputs are used both in the blueprint level and in the grains level. Grains can use inputs and outputs to pass data between IaC components, validate information and eventually lead to reducing the amount of IaC components that needs to be maintained by the organization.