Image Resizer - the IIS/ASP.NET module for everyone

Resize, watermark, crop, rotate and filter from the image URL.
Usable from javascript, css, html, php, ruby, python, asp, asp.net, anything!

Quick start

  1. Download and unzip the package or install the NuGet package. If you're not using ASP.NET, read this guide.
  2. In Visual Studio, right click your project and choose "Add reference". Browse to the extracted folder, and choose dlls\release\ImageResizer.dll. Or just copy it into the 'bin' folder. Whichever you prefer. (Compatible with .NET 2-4).
  3. Modify or create the /Web.Config file for your site:

     <?xml version="1.0" encoding="utf-8" ?>
     <configuration>
         <configSections>
             <section name="resizer" type="ImageResizer.ResizerSection,ImageResizer"  requirePermission="false"  />
         </configSections>
    
         <resizer>
             <!-- Unless you (a) use Integrated mode, or (b) map all reqeusts to ASP.NET, 
                  you'll need to add .ashx to your image URLs: image.jpg.ashx?width=200&height=20 -->
             <pipeline fakeExtensions=".ashx" />
    
             <plugins>
                 <!-- <add name="DiskCache" /> -->
                 <!-- <add name="PrettyGifs" /> -->
             </plugins>  
         </resizer>
    
         <system.web>
             <httpModules>
                 <!-- This is for IIS5, IIS6, and IIS7 Classic, and Cassini/VS Web Server-->
                 <add name="ImageResizingModule" type="ImageResizer.InterceptModule"/>
             </httpModules>
         </system.web>
    
         <system.webServer>
             <validation validateIntegratedModeConfiguration="false"/>
             <modules>
                 <!-- This is for IIS7+ Integrated mode -->
                 <add name="ImageResizingModule" type="ImageResizer.InterceptModule"/>
             </modules>
         </system.webServer>
     </configuration>
    
  4. Start your web site, then visit /resizer.debug.ashx to verify you've done everything correctly. If you ever encounter issues, simply revisit that page to access the self-diagnostics. If you need help, just ask! ASP.NET MVC is fully supported, just install the MvcRoutingShim plugin.

  5. Relax and have fun! This software has been refined and improved since its creation in 2007, with a focus on security, stability, and performance. Check out the history of the project. Unlike all the sample code you find on the internet, it avoids the 29 common image resizing pitfalls. Over 10K websites use the ImageResizer; why not read a few recent testimonials from some of the more well-known people & companies?.

  6. Spread the word! Tell your friends and co-workers about this library. And click the +1 button to tell Google Plus that this is an awesome site. Have ideas or feedback? share them on our UserVoice site, so others can vote up your proposals.

  7. Ready to go live? Make sure you get the disk caching plugin! If your visitors are distributed across the globe, you should also consider signing up for Amazon CloudFront edge-caching, and installing the cloud front plugin. This project requires 50-70 hours of work per week, so make sure you support it by purchasing a plugin bundle or an all-inclusive support contract. Buy purchasing a license, you'll also get a priority phone/TeamViewer support incident.

Can't afford any mistakes? Ensure your content architecture is scalable and secure by having a 30-minute Q&A session with the author for just $70. Add aided installation of 1 server or workstation for +$60, or 2 servers or workstations for +$120. Find out more. Or, get a support contract that includes all of the above and licenses for everything.