Use asp-append-version to Implement Cache Busting for Static Assets

ebeeraheem

View Profile
88 views
Dec 05, 2025

Original link to solution: https://github.com/dotnet/aspnetcore/issues/35553#issuecomment-1004316662

Create the following helper class

public class AppendVersionTagHelperInitializer :
   ITagHelperInitializer<ScriptTagHelper>,
   ITagHelperInitializer<LinkTagHelper>,
   ITagHelperInitializer<ImageTagHelper>
{
   private const bool DefaultValue = true;
   public void Initialize(ScriptTagHelper helper, ViewContext context)
   {
       helper.AppendVersion = DefaultValue;
   }
   public void Initialize(LinkTagHelper helper, ViewContext context)
   {
       helper.AppendVersion = DefaultValue;
   }
   public void Initialize(ImageTagHelper helper, ViewContext context)
   {
       helper.AppendVersion = DefaultValue;
   }
}

Then register the following services to your DI container

builder.Services.AddSingleton<ITagHelperInitializer<ScriptTagHelper>, AppendVersionTagHelperInitializer>();
builder.Services.AddSingleton<ITagHelperInitializer<LinkTagHelper>, AppendVersionTagHelperInitializer>();
builder.Services.AddSingleton<ITagHelperInitializer<ImageTagHelper>, AppendVersionTagHelperInitializer>();

This means that you no longer have to add asp-append-version="true" in order to implement cache busting for static assets like scripts, styles and images.