From 65941d4300e497201a81ab82d30eb754d8e1b903 Mon Sep 17 00:00:00 2001
From: Rui Tome <rtome@bitwarden.com>
Date: Fri, 5 Dec 2025 16:06:34 +0000
Subject: [PATCH] Enhance XML documentation for Premium property in
 OrganizationUserUserDetails and User classes to clarify its usage and
 limitations regarding personal and organizational premium access.

---
 .../OrganizationUsers/OrganizationUserUserDetails.cs          | 4 +++-
 src/Core/Entities/User.cs                                     | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/Core/AdminConsole/Models/Data/Organizations/OrganizationUsers/OrganizationUserUserDetails.cs b/src/Core/AdminConsole/Models/Data/Organizations/OrganizationUsers/OrganizationUserUserDetails.cs
index a760f8d8e3..00ba706a41 100644
--- a/src/Core/AdminConsole/Models/Data/Organizations/OrganizationUsers/OrganizationUserUserDetails.cs
+++ b/src/Core/AdminConsole/Models/Data/Organizations/OrganizationUsers/OrganizationUserUserDetails.cs
@@ -21,7 +21,9 @@ public class OrganizationUserUserDetails : IExternal, ITwoFactorProvidersUser, I
     public string AvatarColor { get; set; }
     public string TwoFactorProviders { get; set; }
     /// <summary>
-    /// User's personal premium subscription status. Does not reflect organization premium access.
+    /// Indicates whether the user has a personal premium subscription.
+    /// Does not include premium access from organizations -
+    /// do not use this to check whether the user can access premium features.
     /// Null when the organization user is in Invited status (UserId is null).
     /// </summary>
     public bool? Premium { get; set; }
diff --git a/src/Core/Entities/User.cs b/src/Core/Entities/User.cs
index d77cb9c524..669e32bcbe 100644
--- a/src/Core/Entities/User.cs
+++ b/src/Core/Entities/User.cs
@@ -71,7 +71,8 @@ public class User : ITableObject<Guid>, IStorableSubscriber, IRevisable, ITwoFac
     public string? SecurityState { get; set; }
     /// <summary>
     /// Indicates whether the user has a personal premium subscription.
-    /// Does not include premium access from organizations.
+    /// Does not include premium access from organizations -
+    /// do not use this to check whether the user can access premium features.
     /// </summary>
     public bool Premium { get; set; }
     public DateTime? PremiumExpirationDate { get; set; }