diff --git a/platform-includes/capture-message/javascript.mdx b/platform-includes/capture-message/javascript.mdx
index b963b0ea9b3d3..79b31e30ad65c 100644
--- a/platform-includes/capture-message/javascript.mdx
+++ b/platform-includes/capture-message/javascript.mdx
@@ -1,3 +1,7 @@
 ```javascript
 Sentry.captureMessage("Something went wrong");
+
+// optionally specify the severity level:
+// "fatal" | "error" | "warning" | "log" | "debug" | "info" (default)
+Sentry.captureMessage("Something went wrong", "warning");
 ```