From 06ec01f9ebfc9e53f69f710d9cb7589719a77160 Mon Sep 17 00:00:00 2001 From: Andy Butland Date: Mon, 30 Jun 2025 07:49:39 +0200 Subject: [PATCH 1/2] Clarified usage of NuCacheSerializerType setting --- .../reference/configuration/cache-settings.md | 27 ++++------------- .../reference/configuration/cache-settings.md | 29 ++++--------------- 2 files changed, 11 insertions(+), 45 deletions(-) diff --git a/15/umbraco-cms/reference/configuration/cache-settings.md b/15/umbraco-cms/reference/configuration/cache-settings.md index 1a1b4122461..78ffda07472 100644 --- a/15/umbraco-cms/reference/configuration/cache-settings.md +++ b/15/umbraco-cms/reference/configuration/cache-settings.md @@ -184,29 +184,12 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The ## NuCacheSerializerType -The `NuCacheSerializerType` setting allows developers to specify the serialization format for NuCache content. This setting is particularly relevant for projects migrating from older versions of Umbraco that relied on JSON formats. +The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content. -To use JSON serialization instead of the default MessagePack: +The fastest and most compact format `MessagePack` option is used by default. -### Using 'Program.cs' +An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache). -```csharp -builder.Services.Configure(options => -{ - options.NuCacheSerializerType = NuCacheSerializerType.JSON; -}); -``` +It is no longer supported with the cache implementation from Umbraco 15+ based on .NET's Hybrid cache. -### Using 'appsettings.json' - -```csharp -{ - "Umbraco": { - "CMS": { - "NuCache": { - "NuCacheSerializerType": "JSON" - } - } - } -} -``` +The option is kept available only for a more readable format suitable for testing purposes. diff --git a/16/umbraco-cms/reference/configuration/cache-settings.md b/16/umbraco-cms/reference/configuration/cache-settings.md index ac31431bb44..43bb952eca2 100644 --- a/16/umbraco-cms/reference/configuration/cache-settings.md +++ b/16/umbraco-cms/reference/configuration/cache-settings.md @@ -1,5 +1,5 @@ --- -description: Information on the Cache settings section +description: Information on the Cache settings section --- # Cache Settings @@ -186,29 +186,12 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The ## NuCacheSerializerType -The `NuCacheSerializerType` setting allows developers to specify the serialization format for NuCache content. This setting is particularly relevant for projects migrating from older versions of Umbraco that relied on JSON formats. +The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content. -To use JSON serialization instead of the default MessagePack: +The fastest and most compact format `MessagePack` option is used by default. -### Using 'Program.cs' +An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache). -```csharp -builder.Services.Configure(options => -{ - options.NuCacheSerializerType = NuCacheSerializerType.JSON; -}); -``` +It is no longer supported with the cache implementation from Umbraco 15+ based on .NET's Hybrid cache. -### Using 'appsettings.json' - -```csharp -{ - "Umbraco": { - "CMS": { - "NuCache": { - "NuCacheSerializerType": "JSON" - } - } - } -} -``` +The option is kept available only for a more readable format suitable for testing purposes. From 3df25634675791b4749569aa474d76ab9f63bcf7 Mon Sep 17 00:00:00 2001 From: Andy Butland Date: Mon, 30 Jun 2025 07:52:25 +0200 Subject: [PATCH 2/2] Fixed grammar --- 15/umbraco-cms/reference/configuration/cache-settings.md | 2 +- 16/umbraco-cms/reference/configuration/cache-settings.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/15/umbraco-cms/reference/configuration/cache-settings.md b/15/umbraco-cms/reference/configuration/cache-settings.md index 78ffda07472..54602d54afc 100644 --- a/15/umbraco-cms/reference/configuration/cache-settings.md +++ b/15/umbraco-cms/reference/configuration/cache-settings.md @@ -186,7 +186,7 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content. -The fastest and most compact format `MessagePack` option is used by default. +The fastest and most compact format `MessagePack` is used by default. An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache). diff --git a/16/umbraco-cms/reference/configuration/cache-settings.md b/16/umbraco-cms/reference/configuration/cache-settings.md index 43bb952eca2..1454fa9efba 100644 --- a/16/umbraco-cms/reference/configuration/cache-settings.md +++ b/16/umbraco-cms/reference/configuration/cache-settings.md @@ -188,7 +188,7 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content. -The fastest and most compact format `MessagePack` option is used by default. +The fastest and most compact format `MessagePack` is used by default. An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache).