Adding Web Optimization to a Web Pages Site

Adding bundling and minification (B/M) in a Web Pages site follows the same formula ASP.NET MVC and Web Forms use:

  1. Declare and register bundles.
  2. Consume bundles from within your views. 

This blog entry describes the basics of using B/M in a Web Page site. For an overview and more details on B/M, see my tutorial Bundling and Minification. You can read about B/M for ASP.NET MVC here and for Web Forms here.

To get started, we’ll create a new Web Pages site.


Open the _AppStart.cshtml file.


Replace the contents with the following code:

@using System.Web.Optimization;

     var bundles = BundleTable.Bundles;
     bundles.UseCdn =   true;   //enable CDN support

    //add link to jquery on the CDN
    var jqueryCdnPath = "";

    bundles.Add(new ScriptBundle("~/bundles/jquery", 

    bundles.Add(new ScriptBundle("~/bundles/jqueryui").Include(

    bundles.Add(new ScriptBundle("~/bundles/jqueryval").Include(

    bundles.Add(new ScriptBundle("~/bundles/modernizr").Include(

    bundles.Add(new StyleBundle("~/Content/css").Include("~/Content/site.css"));

    bundles.Add(new StyleBundle("~/Content/themes/base/css").Include(

New to the optimization framework for .Net 4.5 RTM is CDN support (shown in the yellow highlighted code above).

Consuming the Bundles

Open the layout file and replace the script  and CSS link tags in the <head> element with bundle references.  The original code is shown below:

<!DOCTYPE html>
<html lang="en">
        <meta charset="utf-8" />
        <title>@Page.Title - My ASP.NET Web Page</title>
        <link href="~/Content/themes/base/jquery.ui.all.css" rel="stylesheet" type="text/css" />
        <link href="~/Content/Site.css" rel="stylesheet" type="text/css" />
        <link href="~/favicon.ico" rel="shortcut icon" type="image/x-icon" />
        <script src="~/Scripts/jquery-1.7.1.min.js"></script>
        <script src="~/Scripts/jquery-ui-1.8.20.js"></script>
        <script src="~/Scripts/modernizr-2.5.3.js"></script>
        <meta name="viewport" content="width=device-width" />

The updated code is shown below.

@using System.Web.Optimization;
<!DOCTYPE html>
<html lang="en">
        <meta charset="utf-8" />
        <title>@Page.Title - My ASP.NET Web Page</title>

         @Styles.Render("~/Content/themes/base/css", "~/Content/css");

        <link href="~/favicon.ico" rel="shortcut icon" type="image/x-icon" />


        <meta name="viewport" content="width=device-width" />

With the changes, the CSS and JavaScript can be delivered in bundles. Bundles are referenced in views using the Render method ,  ( Styles.Render for CSS and Scripts.Render for JavaScript).

The default configuration for Web Pages sets the compilation element to debug=true. When the compilation is debug=true, no bundling or minification occurs. Open the Web.config file and change the compilation elements debug attribute to false as shown below:

<?xml version="1.0" encoding="utf-8"?>
    <compilation debug="false" targetFramework="4.0" />
  <!--Elements removed for clarity.-->

Comments (5)
  1. David Carpenter says:

    This is great for a razor site.  Any thoughts on a Web Site Project?   How do you register your bundles without a global.asax that you use on a Web Application Site?

  2. john clarking says:

    there should not be any ';' in the header section of the layout file.

  3. Rookie says:

    I have a question about boudle and IIS caching, now I run into a problem, when I modified a file in a bundle, but the client browser was not be updated, no matter how much I pressed ^F5…. so I thought if that was IIS caching things, if not, How could I do to make the client browswer got the lastest version….thx

  4. WordPress Optimization says:

    .A blog that’s both educative and interesting, and without a doubt, you have hit the nail on the head. The problem is an issue that few folks are speaking intelligently about adding web optimization to webpages. I am very happy that I have found this during my search.

    Thanks for sharing with us.

    You must continue your writing. I am sure, you have a great reader's base already!

Comments are closed.

Skip to main content