SplatDev.Umbraco.Plugins.CacheManager 2.1.6

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package SplatDev.Umbraco.Plugins.CacheManager --version 2.1.6
                    


                    

                
NuGet\Install-Package SplatDev.Umbraco.Plugins.CacheManager -Version 2.1.6
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="SplatDev.Umbraco.Plugins.CacheManager" Version="2.1.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="SplatDev.Umbraco.Plugins.CacheManager" Version="2.1.6" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="SplatDev.Umbraco.Plugins.CacheManager" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add SplatDev.Umbraco.Plugins.CacheManager --version 2.1.6
                    


                    

                
#r "nuget: SplatDev.Umbraco.Plugins.CacheManager, 2.1.6"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package SplatDev.Umbraco.Plugins.CacheManager@2.1.6
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=SplatDev.Umbraco.Plugins.CacheManager&version=2.1.6
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=SplatDev.Umbraco.Plugins.CacheManager&version=2.1.6
                    


                            Install as a Cake Tool

CacheManager

Umbraco cache management and warming plugin — multi-layer caching with EF Core second-level cache, response caching, static file compression, and automated cache warming via background service. Consumes the SplatDev.Cache abstraction for ICacheService/ICacheProvider. Supports Umbraco 13 (net8.0) and Umbraco 17 (net10.0).

CacheManager dashboard

NuGet

Compatibility

Umbraco .NET Package Version
13.x 8.0 2.0.0
17.x 10.0 2.0.0

Installation

dotnet add package SplatDev.Umbraco.Plugins.CacheManager

Quick Start

Register in Program.cs:

builder.CreateUmbracoBuilder()
    .AddBackOffice()
    .AddWebsite()
    .AddCacheManager()   // <-- add this
    .Build();

Architecture — Cache Layers

The plugin wires multiple cache layers via CacheManagerComposer:

Layer Mechanism Scope
EF Second-Level Cache EFCoreSecondLevelCacheInterceptor — MemoryCache provider, 30min absolute expiration All EF queries
Static File Caching Umbraco pipeline filter — Cache-Control: public, max-age=1month CSS, JS, fonts, images
Response Caching ASP.NET Core UseResponseCaching — 5min max-age via Cache-Control header HTML page responses
Method Caching SplatDev.Cache (ICacheService/ICacheProvider) singleton App-level method results

Configuration

// appsettings.json
{
  "ConnectionStrings": {
    "umbracoDbDSN": "Server=.;Database=Umbraco;..."
  },
  "CacheManager": {
    "EFCacheMinutes": 30,
    "StaticFileMaxAgeDays": 30,
    "ResponseCacheMinutes": 5
  }
}

Backoffice Dashboard

The plugin adds a Cache Manager dashboard under the Settings section:

Endpoint Action
GET CleanCache Clear in-memory cache
GET RefreshCache Clear + re-warm entire cache via background service
GET GetLastTask View cache warmer history from DB
GET GetUrlNotFound Top 100 URLs that returned 404
GET GetStatistics Cache key counts (DB keys, method keys)

Cache Warming

CacheWarmerBackgroundService runs as a hosted service:

  1. Scrapes published content URLs from CacheWarmerEntry table
  2. Issues HTTP GET requests to warm the response cache
  3. Logs results to CacheWarmerEntryRepository
  4. Tracks "not found" URLs in UrlNotFoundRepository

Trigger manually from the backoffice dashboard or let the background service run on schedule.

Dependencies

  • SplatDev.Cache — cache abstraction layer (ICacheService, ICacheProvider)
  • EFCoreSecondLevelCacheInterceptor — EF query result caching
  • Microsoft.EntityFrameworkCore — DB context for cache tracking tables

Changelog

2.1.6 — 2026-08-21

  • Dashboard now sends the backoffice token with its API calls. On Umbraco 17 those calls were arriving unauthenticated and coming back 401, which the dashboard rendered as an empty state rather than an error.
  • A failed request now raises a notification instead of leaving the dashboard looking like there is simply no data.
  • Runs on SQLite as well as SQL Server. It previously assumed SQL Server and failed with "Keyword not supported: 'cache'" on the database Umbraco's installer offers by default.
  • Internal extension namespace corrected — it was left over from another plugin.

License

MIT © SplatDev

Feedback

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.8 44 8/22/2026
2.1.7 43 8/21/2026
2.1.6 44 8/21/2026
2.1.5 68 8/20/2026
2.1.4 92 8/12/2026
2.1.3 90 8/12/2026
2.1.2 93 8/11/2026
2.1.1 86 8/11/2026
2.1.0 87 8/11/2026
2.0.1 149 6/1/2026
2.0.0 120 6/1/2026