diff --git a/src/OrchardCore/OrchardCore.Users.Core/Services/ConfigureSecurityStampOptions.cs b/src/OrchardCore/OrchardCore.Users.Core/Services/ConfigureSecurityStampOptions.cs
index 01cc9d179b2..d255bedb52d 100644
--- a/src/OrchardCore/OrchardCore.Users.Core/Services/ConfigureSecurityStampOptions.cs
+++ b/src/OrchardCore/OrchardCore.Users.Core/Services/ConfigureSecurityStampOptions.cs
@@ -10,6 +10,8 @@ public class ConfigureSecurityStampOptions : IPostConfigureOptions<SecurityStamp
 {
     public void PostConfigure(string name, SecurityStampValidatorOptions options)
     {
+        // While updating the principal, any customized claims set using IUserClaimsProvider
+        // or obtained from an external identity will persist and transfer to the refreshed/new principal.
         options.OnRefreshingPrincipal = principalContext =>
         {
             var currentIdentity = principalContext.CurrentPrincipal?.Identities?.FirstOrDefault();