diff --git a/src/Umbraco.Core/Configuration/Models/NuCacheSerializerType.cs b/src/Umbraco.Core/Configuration/Models/NuCacheSerializerType.cs
index 0506ddb98b..a012f47aa3 100644
--- a/src/Umbraco.Core/Configuration/Models/NuCacheSerializerType.cs
+++ b/src/Umbraco.Core/Configuration/Models/NuCacheSerializerType.cs
@@ -4,10 +4,23 @@
namespace Umbraco.Cms.Core.Configuration.Models;
///
-/// The serializer type that nucache uses to persist documents in the database.
+/// The serializer type that the published content cache uses to persist documents in the database.
///
public enum NuCacheSerializerType
{
- MessagePack = 1, // Default
+ ///
+ /// The default serializer type, which uses MessagePack for serialization.
+ ///
+ MessagePack = 1,
+
+ ///
+ /// The legacy JSON serializer type, which uses JSON for serialization.
+ ///
+ ///
+ /// This option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache).
+ /// It is no longer supported with the cache implementation from Umbraco 15 based on .NET's Hybrid cache.
+ /// Use the faster and more compact instead.
+ /// The option is kept available only for a more readable format suitable for testing purposes.
+ ///
JSON = 2,
}