diff --git a/pkg/devfile/header.go b/pkg/devfile/header.go
index 5b6aa75e6..f40380e36 100644
--- a/pkg/devfile/header.go
+++ b/pkg/devfile/header.go
@@ -43,7 +43,7 @@ type DevfileMetadata struct {
 	// +optional
 	Tags []string `json:"tags,omitempty"`
 
-	// Optional devfile icon
+	// Optional devfile icon, can be a URI or a relative path in the project
 	// +optional
 	Icon string `json:"icon,omitempty"`
 
diff --git a/schemas/latest/devfile.json b/schemas/latest/devfile.json
index 30836dc1f..ed0386a6a 100644
--- a/schemas/latest/devfile.json
+++ b/schemas/latest/devfile.json
@@ -654,7 +654,7 @@
           "type": "string"
         },
         "icon": {
-          "description": "Optional devfile icon",
+          "description": "Optional devfile icon, can be a URI or a relative path in the project",
           "type": "string"
         },
         "language": {
diff --git a/schemas/latest/ide-targeted/devfile.json b/schemas/latest/ide-targeted/devfile.json
index 853d53852..da2946629 100644
--- a/schemas/latest/ide-targeted/devfile.json
+++ b/schemas/latest/ide-targeted/devfile.json
@@ -721,9 +721,9 @@
           "markdownDescription": "Optional devfile global memory limit"
         },
         "icon": {
-          "description": "Optional devfile icon",
+          "description": "Optional devfile icon, can be a URI or a relative path in the project",
           "type": "string",
-          "markdownDescription": "Optional devfile icon"
+          "markdownDescription": "Optional devfile icon, can be a URI or a relative path in the project"
         },
         "language": {
           "description": "Optional devfile language",