Per Bjurström
May 19, 2009
(4 votes)

CdnSupport module preview 2

Please read this article about Preview 1 before you continue reading, it covers the basics.

I’ve added another feature to the CDN module to support “far future Expires-header”. As described in Preview 1 you need to set an Expires header on your files for the CDN to cache your files, this header controls how long the CDN (as well as the browser) is allowed to keep the file in the cache. The longer the better, but then changes you make to existing files may never get updated.

You should still use that but since this module supports injecting changed date information into the URL we can enhance it with the “far future” pattern as described by Best Practices for Speeding Up Your Web Site. This feature is enabled by changing the StaticFileHandler in EPiServer CMS to a slightly modified version, this modified handler discovers CDN-requests and changes the Expires-header to the far future (1 year, which is the maximum in ASP.NET). Whenever a “normal” request comes in it just passes the request to the built-in handler in EPiServer CMS. Best of both worlds.

This feature is optional, you don’t have to use it since you could set the expires to a far future on the built-in StaticFileHandler but that will affect all requests (even those without the changed date in the URL). By the way, have a look at System.Web.HttpCachePolicy.SetExpires in Reflector. You are not allowed to increase the expires, only decrease it. Nice one. That is why this feature is implemented as an StaticFileHandler instead of just listening to events.

Snapshot from Firebug:



Configuration required (on every VPP you whish to enable it for):

   1: <location path="Global">
   2:     <staticFile expirationTime="1.0:0:0"/>
   3:     <system.webServer>
   4:         <handlers>
   5:             <add name="webresources" path="WebResource.axd" verb="GET" type="System.Web.Handlers.AssemblyResourceLoader"/>
   6:             <add name="wildcard" path="*" verb="*" type="EPiServer.CdnSupport.CdnStaticFileHandler, EPiServer.CdnSupport"/>
   7:         </handlers>
   8:     </system.webServer>
   9: </location>


This version also fixes a bug that only surfaced if you were running an Enterprise-configuration, basically the site did not start.

Remember that the StaticFileHandler only delivers files located in EPiServer, not CSS-files etc (at least on IIS7). The recommended pattern for external files is that you version your resources on the site yourself. Again, see the Best Practices for Speeding Up Your Web Site.

Download the package here.

May 19, 2009


Sep 21, 2010 10:32 AM

Per, I could kiss you! Or at least almost :)
On the project that I'm currently working on we've been playing around with the CDN-module to improve the sites ranking in YSlow (which compares a site against the above mentioned performance rules) and this improvement just made my day! Thank you!
/ Joel Abrahamsson (

Sep 21, 2010 10:32 AM

Wow, that is timing! Let me know if you have any feedback or suggestions.

Sep 21, 2010 10:32 AM

Per, got any advice on how to make the module handle javascript files added with a scriptmanager? Currently it rewrites all paths and adds the date information to the url except two js-files that are referenced through the scriptmanager.
/ Joel Abrahamsson (

Sep 21, 2010 10:32 AM

I tried to implement support for those ScriptResource/WebResource files but did not get it to work, so I gave up on that approach.

I would look into customizing ScriptManager instead, let me know if you find anything.

Sep 21, 2010 10:32 AM

I see, but in this case it's for js-files and not scriptresources/webresources, but it's quite possible that I'm missing something in my configuration. Will look into that.

A bit more feedback/issues:

* It doesn't seem to rewrite relative urls in html-comments, like

* It seems to add expirationheaders to the above css-file even though the URL is not rewritten and I'm using the CdnStaticFileHandler. My configuration for the styles location looks like this:

/ Joel Abrahamsson (

Sep 21, 2010 10:32 AM

You should not get the 1-year expiration header on files that are not rewritten, in your case you should get 3 days since that is what you have specified as default. Basically the CdnStaticFileHandler just passed the request to the built-in version if its not a CDN request.

Sep 21, 2010 10:32 AM

Ahh, brilliant!
/ Joel Abrahamsson (

Wacdany R.
Wacdany R. Jul 18, 2013 05:09 AM

Hello Per,

Thank you so much for this collaboration! It really looks promising.
We are looking to implement a CDN support for Akamai on EpiServer 7 and since this post dates for 2009 I just wonder if you have done any compatibility test for this module on EpiServer7 or if there is any other recommendations you might have regarding Akamai CDN + EpiServer7?

Best Regards,
- Wacdany R.

Please login to comment.
Latest blogs
Translating Optimizely CMS 12 UI components

Optimizely CMS 12 have been out for a while now, but still some elements haven't been properly translated resulting in a GUI defaulting to english....

Eric Herlitz | Jan 26, 2023 | Syndicated blog

Image preview in Optimizely CMS12 all properties view

With these simple steps, you can now see an Image and its Metadata, including size and dimensions, when editing an Image property in Optimizely...

Tomas Hensrud Gulla | Jan 26, 2023 | Syndicated blog

Setting up the ImageEditor in Optimizely CMS 12

Setting up certain configurations on Opimizely CMS 12 differs quite a bit from prior versions of (Episerver CMS 11 and older). Here's a small guide...

Eric Herlitz | Jan 25, 2023 | Syndicated blog

Happy Hour Returning in February

Hi everyone! It's been a while and we're excited to resume our Happy Hour in February for more learning, sharing, connecting, relaxing, and just to...

Patrick Lam | Jan 24, 2023

Planned breaking change for Locale parameter in Content Graph

Content Graph, a new service which makes it possible to query content using GraphQL, will have a breaking change soon. The service is currently in...

Jonas Bergqvist | Jan 23, 2023

Optimizely Advanced ContentArea Render is Back!

If you have used EPiBootstrapArea package - then back in those days we had an opportunity to render Episerver ContentArea items with different...

valdis | Jan 23, 2023 | Syndicated blog