diff --git a/pkg/chart/common/util/jsonschema.go b/pkg/chart/common/util/jsonschema.go
index 752184c7d..94a3171d1 100644
--- a/pkg/chart/common/util/jsonschema.go
+++ b/pkg/chart/common/util/jsonschema.go
@@ -84,6 +84,9 @@ func ValidateAgainstSchemaWithPath(ch chart.Charter, values map[string]any, char
 		return err
 	}
 
+	// Convert chartDir to absolute path for $ref resolution.
+	// If chartDir is empty (e.g., chart loaded from .tgz archive), absChartPath
+	// remains empty and a synthetic path will be used instead.
 	var absChartPath string
 	if chartDir != "" {
 		var err error