Using Azure CDN with Sitecore 7

Today I'm going to talk about the CDN service provided by Microsoft Azure. If you have a website there you will find this service very useful and you can implement it super fast. A Content Delivery Network (CDN) works by providing alternative server nodes for users to download resources (usually static content like images and JavaScript). These nodes spread throughout the world, therefore being geographically closer to your users, ensuring a faster response and download time of content due to reduced latency.

Microsoft provide a CDN service on the cloud. This service needs to take the static files from a local folder on the same website. I'm going to show you how to add to Sitecore the feature to clone all the files of the Media Library into this folder. This action is going to happen just when you publish those items from the Master database to Web database. Also, you will have to accomplish some extra configurations on the Content Delivery servers to take them from the CDN servers.

I'm going to show you and I'm going to provide you a package to use Azure CDN with your Sitecore 7.* project hosted in Azure.

This package is already on the Sitecore Marketplace. Also, the source code is on Github too.

Step 1 - Create the CDN service on Azure.

Got to the App Services section. Press on the CDN option. Then press on the Quick Create button. On the Origin Domain dropdown select the URL of your website. (Note: CDN is going to search the images on a CDN folder in the root of your website). After the creation of the CDN service, I'll recommend to enable HTTPS on it.

Step 2 - Install the package and config it

You have to install the package on the site that you have selected on the dropdown when you create the Azure CDN service.

After the installation, you will see a new file in the folder /App_Config/Includes. The file is called SitecoreFromArg.CdnAzure.config and it has 2 parameters inside:

Enabled: This parameter allow you to disable this feature.

SourceDomain: You can use this parameter to change the name of the default folder where Azure is looking for the static files.

Step 3 - Republish media items

Go to Content Editor on the server where you have installed the package, and republish all the items of the Media Library folder.

Final step - Change the configurations on the Content Delivery servers

Set the parameter Media.AlwaysIncludeServerUrl in true:
<setting name="Media.AlwaysIncludeServerUrl" value="true" />

Add the following string in the parameter Media.MediaLinkPrefix:
<setting name="Media.MediaLinkPrefix" value="~/"/>

Add the CDN Domain on the parameter Media.MediaLinkServerUrl (this parameter isn't on Sitecore 6.*):
<setting name="Media.MediaLinkServerUrl" value=""/>

Finally, remove the attribute value="ashx" from the parameter Media.RequestExtension:
<setting name="Media.RequestExtension" />

There is the code of my package


  1. Hello Lautaro,
    Thank you for the information..

    I have a query. What I have understood is this module will create a folder structure based on your media library structure on the publish event of media. It will not upload the media to the Azure storage account.Do you know how this can be achieved because media files will be fetched from the Azure Storage account only.

    Please correct me if I am wrong.

    1. Hi Alok,
      That folder is enough. You don't need to upload them to Azure Storage. When you create the CDN service, the wizard will ask you about the website where you want to apply this service. In this moment CDN will start listening the files you create on this special folder. You can test it easily adding an static file to this folder manually.

      I'm not sure if I was clear on my explanation. Please ask me any other question you have.

  2. We are unable to connect to the content delivery network (CDN) that delivers the video stream? and how can you fix it?
    global server load balancing

    1. Video streaming and static files are not addressed in the same way for the CDNs. The main idea behind the CDN is the same one, but each service is implementing it technically in a different way. You have to ask this question to the technical support of the service you have selected. Also, the infrastructure approach you are using could impact on this issue as well. Apologies, I cannot help you.

  3. What is SSL?is this important to have it when u order web hosting?
    what is cdn

    1. Glad you post a question on my blog, but I'm not seeing a relationship between this question and CDN, Azure or Sitecore.
      Going back to your question, here you have an excellent explanation about SSL (
      This feature is important if you want to encrypt the communication between the hosting and the users.

  4. This is a very nice article. thank you for publishing this. i can understand this easily..!!..Azure Online Course