diff --git a/primitives/src/v2/mod.rs b/primitives/src/v2/mod.rs
index 06326676c9d2..9191ebea5b2c 100644
--- a/primitives/src/v2/mod.rs
+++ b/primitives/src/v2/mod.rs
@@ -1603,6 +1603,9 @@ pub fn supermajority_threshold(n: usize) -> usize {
 }
 
 /// Information about validator sets of a session.
+///
+/// NOTE: `SessionInfo` is frozen. Do not include new fields, consider creating a separate runtime
+/// API. Reasoning and further outlook [here](https://github.com/paritytech/polkadot/issues/6586).
 #[derive(Clone, Encode, Decode, RuntimeDebug, TypeInfo)]
 #[cfg_attr(feature = "std", derive(PartialEq))]
 pub struct SessionInfo {