diff --git a/docs/platforms/godot/configuration/options.mdx b/docs/platforms/godot/configuration/options.mdx
index c14740cc651db..47b0fa94b47f6 100644
--- a/docs/platforms/godot/configuration/options.mdx
+++ b/docs/platforms/godot/configuration/options.mdx
@@ -122,6 +122,24 @@ This option is turned off by default.
 
 </SdkOption>
 
+<SdkOption name="app_hang_tracking" type="bool" defaultValue="false">
+
+If `true`, enables automatic detection and reporting of application hangs. The SDK will monitor the main thread and report hang events when it becomes unresponsive for longer than the duration specified in `app_hang_timeout_sec`. This helps identify performance issues where the application becomes frozen or unresponsive.
+
+<Alert title="Note">
+
+This feature is only supported on Android, iOS, and macOS platforms.
+
+</Alert>
+
+</SdkOption>
+
+<SdkOption name="app_hang_timeout_sec" type="float" defaultValue="5.0">
+
+Specifies the timeout duration in seconds after which the application is considered to have hanged. When `app_hang_tracking` is enabled, if the main thread is blocked for longer than this duration, it will be reported as an application hang event to Sentry.
+
+</SdkOption>
+
 ## GUI-only Options
 
 These options are only available in the **Project Settings** window.