diff --git a/content/developer/reference/frontend/javascript_reference.rst b/content/developer/reference/frontend/javascript_reference.rst
index d0676261c..88d6f2433 100644
--- a/content/developer/reference/frontend/javascript_reference.rst
+++ b/content/developer/reference/frontend/javascript_reference.rst
@@ -1024,7 +1024,8 @@ from the *ServiceMixin*:
     - *subtitle*: string, optional. This will be displayed on the top as a
       subtitle.
 
-    - *message*: string, optional. The content of the notification.
+    - *message*: string, optional. The content of the notification. Do not forget
+      to escape your message via the markup function if needed.
 
     - *sticky*: boolean, optional (default false). If true, the notification
       will stay until the user dismisses it.  Otherwise, the notification will
@@ -1037,11 +1038,6 @@ from the *ServiceMixin*:
       automatically added to the notification.  This could be useful for styling
       purpose, even though its use is discouraged.
 
-    - *messageIsHtml*: boolean, optional (default false). Allows passing an html
-      message. Strongly discouraged: other options should be considered before
-      enabling this option. The responsibility is on the caller to properly
-      escape the message if this option is enabled.
-
 Here are two examples on how to use these methods:
 
 .. code-block:: javascript