diff --git a/platform-includes/capture-message/php.mdx b/platform-includes/capture-message/php.mdx
index c48c474ac674e..f6f9d2bd04c7e 100644
--- a/platform-includes/capture-message/php.mdx
+++ b/platform-includes/capture-message/php.mdx
@@ -1,3 +1,7 @@
 ```php
 \Sentry\captureMessage('Something went wrong');
+
+// Optionally, specify a severity level.
+// Supported levels: debug, info, warning, error, fatal.
+\Sentry\captureMessage('Something went wrong', \Sentry\Severity::warning());
 ```