diff --git a/Terminal.Gui/Views/MessageBox.cs b/Terminal.Gui/Views/MessageBox.cs
index bdbf323a0..073bb2d1f 100644
--- a/Terminal.Gui/Views/MessageBox.cs
+++ b/Terminal.Gui/Views/MessageBox.cs
@@ -56,7 +56,14 @@ public static class MessageBox
/// based console where there is no SynchronizationContext or TaskScheduler.
///
///
- /// Warning: This is a global variable and should be used with caution. It is not thread safe.
+ ///
+ /// Warning: This is a global variable and should be used with caution. It is not thread safe.
+ ///
+ ///
+ /// Deprecated: This property is maintained for backward compatibility. The MessageBox methods
+ /// now return the button index directly, and provides a cleaner,
+ /// non-global alternative for custom dialog implementations.
+ ///
///
public static int Clicked { get; private set; } = -1;
@@ -340,7 +347,6 @@ public static class MessageBox
// Create button array for Dialog
var count = 0;
List