diff --git a/lib/core/engine/command/measure.js b/lib/core/engine/command/measure.js
index 733876f10..a363bc309 100644
--- a/lib/core/engine/command/measure.js
+++ b/lib/core/engine/command/measure.js
@@ -478,8 +478,9 @@ export class Measure {
 
   /**
    * Adds a custom metric to the current measurement result.
-   * This method should be called after a measurement has started and before it has stopped.
-   *
+   * The metric will be attached to the latest tested page, meaming
+   * you need to have measured a URL and stopped the measurement before
+   * you add the metric.
    * @param {string} name - The name of the metric.
    * @param {*} value - The value of the metric.
    * @throws {Error} Throws an error if called before a measurement cycle has started.
@@ -497,7 +498,9 @@ export class Measure {
   /**
    * Adds multiple custom metrics to the current measurement result.
    * This method accepts an object containing multiple key-value pairs representing different metrics.
-   * Similar to `add`, it should be used within an active measurement cycle.
+   * The metric will be attached to the latest tested page, meaming
+   * you need to have measured a URL and stopped the measurement before
+   * you add the metric.
    *
    * @param {Object} object - An object containing key-value pairs of metrics to add.
    * @throws {Error} Throws an error if called before a measurement cycle has started.