diff --git a/src/framework/components/light/component.js b/src/framework/components/light/component.js
index 0eab912ca85..33f287cf54d 100644
--- a/src/framework/components/light/component.js
+++ b/src/framework/components/light/component.js
@@ -530,8 +530,9 @@ class LightComponent extends Component {
     }
 
     /**
-     * Sets the angle at which the spotlight cone starts to fade off. The angle is specified in
-     * degrees. Affects spot lights only. Defaults to 40.
+     * Sets the half-angle (measured in degrees from the light's direction axis to the cone edge)
+     * at which the spotlight cone starts to fade off. The full inner beam angle is twice this
+     * value. Affects spot lights only. Defaults to 40 (i.e. an 80-degree full inner beam).
      *
      * @type {number}
      */
@@ -542,7 +543,8 @@ class LightComponent extends Component {
     }
 
     /**
-     * Gets the angle at which the spotlight cone starts to fade off.
+     * Gets the half-angle (measured in degrees from the light's direction axis to the cone edge)
+     * at which the spotlight cone starts to fade off.
      *
      * @type {number}
      */
@@ -551,8 +553,9 @@ class LightComponent extends Component {
     }
 
     /**
-     * Sets the angle at which the spotlight cone has faded to nothing. The angle is specified in
-     * degrees. Affects spot lights only. Defaults to 45.
+     * Sets the half-angle (measured in degrees from the light's direction axis to the cone edge)
+     * at which the spotlight cone has faded to nothing. The full outer beam angle is twice this
+     * value. Affects spot lights only. Defaults to 45 (i.e. a 90-degree full outer beam).
      *
      * @type {number}
      */
@@ -563,7 +566,8 @@ class LightComponent extends Component {
     }
 
     /**
-     * Gets the angle at which the spotlight cone has faded to nothing.
+     * Gets the half-angle (measured in degrees from the light's direction axis to the cone edge)
+     * at which the spotlight cone has faded to nothing.
      *
      * @type {number}
      */