Alexander Haneng
Sep 27, 2010
(0 votes)

EPiImage Part 3: EPiImageGallery Property

The EPiImageGallery property gives you preview thumbnails in edit mode, drag and drop sorting and the possibility to add an image description to each image.


This is the third part of a four part series that started with EPiImage Part 1: EPiImageResizer


EPiImageGallery Property

The EPiImageGallery property is a custom property that have the following features:

  1. Thumbnail view of all the pictures in the gallery in edit mode
  2. Click the “i” button to preview the image and add an image description
  3. Drag and drop sorting



This is what the EPiImageGallery Property looks like in edit mode if no image is selected. If clicked the normal file selection dialog box is opened.

This is what the EPiImageGallery Property looks like in edit mode if it contains images. A thumbnail of each image is shown, and the images can be dragged and dropped into the right sequence. On mouse over the “i” button is shown, if clicked it opens a preview window where image description can be added.


If you click the “i” button you will see a bigger preview of the image and you have the possibility to add a description.


How do I start using it?

Simply download the module from EPiCode and install it using EPiServer Deployment Center. (It just copies in a few files, it doesn’t touch your web.config or require a rebuild)

You will now get a new property type called “EPiImageGallery”:



How do I access the property value?

You can use the EPiImagegallery Viewer user control, or you can access the collection of images directly using the GetImages(CurrentPage) method.

Here is an example:

   //Get the property
    if (!CurrentPage.Property["EPiImageGalleryProperty"].IsNull)
      EPiImageGalleryProperty galleryProperty = 
CurrentPage.Property["EPiImageGalleryProperty"] as EPiImageGalleryProperty; if (galleryProperty != null) { //Get the images by calling GetImages(CurrentPage) EPiImageGalleryImageCollection imageCollection =
galleryProperty.GetImages(CurrentPage); //Databind the image collection to a repeater repGallery.DataSource = imageCollection; repGallery.DataBind(); } }


  <asp:Repeater ID="repGallery" runat="server">
      Image url: 
      <%# (Container.DataItem as EPiImageGalleryImage).ImageURL %><br />
      <%# (Container.DataItem as EPiImageGalleryImage).Description %> 


Have feedback? Want to help out?

Feel free to email or twitter me with your feedback: @ahaneng :-)

And finally: Thank you to Making Waves for donating it to EpiCode!

Next and last post: EPiImageGallery Viewer.

Sep 27, 2010


Michael Horsch
Michael Horsch Mar 22, 2011 06:28 PM

What if I want to use more than 1 per page? The front end of this tool breaks because you've used 'EPiImageGallery' as the id for the div's and then the js doesn't properly handle it from there going forward.

I really like the tool but would like to use more than 1 on the same page type! :)

Please login to comment.
Latest blogs
How to use CacheTagHelper with content areas in Optimizely CMS 12

I might be going out on a limb here - if you have a better solution, feel very free to share it!  Upgrading your Optimizely web application from .N...

Andreas J | Dec 2, 2022

The 1001st Piece in your 1000 Piece Puzzle: .NET Default Interface Functions

I was recently working with a client who wanted a reasonably large subsystem added to Optimizely that would add automated management to their...

Greg J | Nov 28, 2022 | Syndicated blog

Video Demonstration, creating a CMS12 Alloy Sample Site

Hey All Below you will find a quick video demonstration on how to install a local version of Alloy Sample based on CMS12 / .Net 6. As you will see ...

Minesh Shah (Netcel) | Nov 28, 2022

How to create an admin user I Optimizely CMS – with Episerver CLI

In this blog post I’ll show how to create an admin user for Optimizely CMS in a new environment where you don’t have access to the admin interface.

Ove Lartelius | Nov 28, 2022 | Syndicated blog