diff --git a/src/lib/Limitation/LocationLimitationType.php b/src/lib/Limitation/LocationLimitationType.php
index e0ce4ec2b6..3c7cd6571f 100644
--- a/src/lib/Limitation/LocationLimitationType.php
+++ b/src/lib/Limitation/LocationLimitationType.php
@@ -224,9 +224,10 @@ public function getCriterion(APILimitationValue $value, APIUserReference $curren
     }
 
     /**
-     * Returns an integer code meaning that the value must be an array listing location IDs.
+     * Returns info on valid $limitationValues.
      *
-     * @return int {@see LocationLimitationType::VALUE_SCHEMA_LOCATION_ID}
+     * @return mixed[]|int In case of array, a hash with key as valid limitations value and value as human readable name
+     *                     of that option, in case of int on of VALUE_SCHEMA_ constants.
      */
     public function valueSchema()
     {
diff --git a/src/lib/Limitation/SubtreeLimitationType.php b/src/lib/Limitation/SubtreeLimitationType.php
index 3ceb4cee0d..c642ec64e8 100644
--- a/src/lib/Limitation/SubtreeLimitationType.php
+++ b/src/lib/Limitation/SubtreeLimitationType.php
@@ -258,9 +258,10 @@ public function getCriterion(APILimitationValue $value, APIUserReference $curren
     }
 
     /**
-     * Returns an integer code meaning that the value must be an array listing location paths.
+     * Returns info on valid $limitationValues.
      *
-     * @return int {@see SubtreeLimitationType::VALUE_SCHEMA_LOCATION_PATH}
+     * @return mixed[]|int In case of array, a hash with key as valid limitations value and value as human readable name
+     *                     of that option, in case of int on of VALUE_SCHEMA_ constants.
      */
     public function valueSchema()
     {