diff --git a/src/WidgetUtils.js b/src/WidgetUtils.js
index 14fe3f59bd..98ee935f35 100644
--- a/src/WidgetUtils.js
+++ b/src/WidgetUtils.js
@@ -100,7 +100,8 @@ export default class WidgetUtils {
      * @param {string} widgetId The ID of the widget to wait for
      * @param {boolean} add True to wait for the widget to be added,
      *     false to wait for it to be deleted.
-     * @returns {Promise} that resolves when the widget is available
+     * @returns {Promise} that resolves when the widget is the the
+     *     requested state according to the `add` param
      */
     static waitForUserWidget(widgetId, add) {
         return new Promise((resolve, reject) => {
@@ -146,7 +147,8 @@ export default class WidgetUtils {
      * @param {string} roomId The ID of the room to wait for the widget in
      * @param {boolean} add True to wait for the widget to be added,
      *     false to wait for it to be deleted.
-     * @returns {Promise} that resolves when the widget is available
+     * @returns {Promise} that resolves when the widget is the the
+     *     requested state according to the `add` param
      */
     static waitForRoomWidget(widgetId, roomId, add) {
         return new Promise((resolve, reject) => {