All project content is available for reading, but you need to be a member of the project for Subversion checkout of source code, or to create/modify any information.
Login if you are a member. Apply here to request membership (open to all).


EPiImage is an award winning, free module that provides image scaling functionality, as well as two new property types: EPiImage Property that extends “URL to image” with a preview, and EPiImageGallery Property that provides a editor friendly way to add pictures to a gallery including drag and drop sorting, drag and drop adding of images from the file action menu (including whole folders), description texts, links etc.

For a quick 2 minute intro to EPiImage check out this video:

It consists of 5 parts:

The resizer provides fast image resizing with caching.

The EPiImageGallery property in edit mode. With drag and drop adding of images straight from the file action menu.

Sample slideshow user control for rendering EPiImageGallery Properties: EPiImage Gallery Viewer

Another sample user control for rendering EPiImageGallery Properties: EPiImage Gallery Grid


See the individual parts for details about functionality and usage.

Current version

The current version is 2.9.1. (File version:


Also available at EPiServer's Nuget feed

EPiImage 1.5 is also available: Works with EPiServer CMS 5 R2 SP2 & CMS 6 R1: EPiImage1.5.epimodule


Install the .epimodule file using the EPiServer Deployment Center or from EPiServer's Nuget feed

There are two demo page types available in the /EPiImage/DemoTemplates/ folder. Import the EPiImageDemoPageTypes.episerverdata file to import the page types. Requires EPiServer CMS 6 R2 with the Alloy demo.


No configuration is needed, but some configurations are available. See the configuration page for more information.

Known limitations

  • If the editor changes the image file and doesn't save it with a new file name, the old scaled image will still be cached. Clear the cache in admin using the "EPiImage Cleanup" tool.
  • You can't add an EPiImageProperty or a EPiImageGalleryProperty to a Dynamic Content.


Tickets for this component:

Two EPiImage properties on one page only renders the last one
Remove HttpContext dependency
Prev- next buttons
EPiImage Delete and AltText links
EPiImage images renaming
Make configuration use standard asp.net features
Request for language files and Norwegian translations
Stack overflow in EPiImageGalleryImageCollection
double slashes causes exception
Gallery property is not rendering in Chrome
Slides with empty IDs are created and cannot be removed
Problem with unique value per language for Image Gallery
Possible bug?
Broken image when cancel out of file manager
EPiImageGalleryProperty disappears in Edit-mode when another property using jqueryUI is on the page
Possibility to have an fallbackimage to usercontrols?
Unable to remove empty image frames from gallery.
The gallery property doesn't work in chrome
EPiImageResizer: Alt attribute is required on images
Images disappear
Bug when using EPiImageGalleryProperty in PageTypeBuilder 2.0 PropertyGroup
Image disappears if its URL contains ampersand
Unable to compare pages that has an EPiImageGallery property
Drag and Drop Folder does not work with space in folder name
Drag and Drop Folder causes unexpected behaviour when folder empty
EPiImageResizer doesn't seem to work if image is located in folder with space in folder name.
EPiImage Checkout issue
Saving without publishing duplicates images in the view
EPiImage Gallery stopped working
Clean-up job issue in load balanced environment with shared VPP
EPiImageGalleryImageCollection becomes empty after some period of time
Images referred by EPiImage ignored by mirrorservice
Access right EPiImage Cleanup
Resize image of same aspect ratio fails sometimes
After creating a new version of an image, the edit mode thumbnail is not updated
Property EPiImageGallery doesn't show control for adding images in edit state.
EPiImage Improvements
Moving an Image Issue
EPiImage issues
Deserialize issue when using EPiImage with ElencySolutions.MultipleProperty

Ask a question

Requires login.

Report a bug

Requires login.

Add a feature request

Requires login.



Awarded "EPiCode Module of the Year 2010"



  • EPiServer CMS 6 and CMS 6 R2
  • .NET 4

If you want to change and compile the source code:

  • Visual Studio 2010
  • To create the module you need 7-Zip installed (free)

Contributed by

Alexander Haneng (Making Waves)

Want to help?

This module wouldn't be possible without help from the community (see the acknowledgement list further down).

If you like to help please check the list below for what we currently need help with:

  • How does EPiServer trigger the file copy behavior described in bug #257?


  • Thanks to Thomas Leela at EPiNova for adding the drag and drop of files and folders from the action window.
  • Thanks to Jon Espen Kvisler at Prokom for helping with bug #271
  • Thanks to Fredrik Lange at Metamatrix for beta testing v. 2.5
  • Thanks to Sveinung at BV Network for fixing a big bug and providing feedback
  • Thanks to Andreas Knudsen at Forse AS for adding the PageLink attribute to EPiImageResizer
  • Thanks to Steve Celius at BV Network for great feedback, refactoring, improvements, installer etc.
  • Thanks to Mari Jørgensen at BV Network for feedback and beta testing.
  • Thanks to the Making.Common team in Making Waves Poland. I got a lot of inspiration from the MakingWaves.Common.Web.Image control.
  • Thanks to Krzysztof Szczęsny at Making Waves Poland for help implementing the slide functionality used for the EPiImage Gallery Viewer

(If I forgot to add you to this list, please let me know. Thank you for helping out with the module)