Skip to main content

Cache Busting Back-Office Client-Side Assets With Umbraco 9+

Since I started at Umbraco the link I've shared the most when helping with support issues has been a blog post article by Dennis Adofi titled "Bumping The Client Dependency Version". It describes the method used to ensure caches are cleared for client-side assets in the back-office for Umbraco versions up to 8.

There's a similar setting for Umbraco 9+ which I've recently had to look up a few times. The configuration setting is at: Umbraco : CMS : RuntimeMinification: Version and is set to a numeric value.

It's documented here and, as described, uses a similar version number that can be increment manually or via a build process to ensure the same cache busting behaviour.

When upgrading Umbraco to a new version of the CMS you don't need to worry about this, as the version running is already used in the hash that is generated for the cache key. But this doesn't take into account package installs, or your own custom extensions to the back-office.

So in you are "not seeing what you expect to see" on the client-side following an upgrade or a deploment, check to see if you have incremented this value, and if not, try to see if that resolves the issues you are having.