SaaS CMS has officially launched! Learn more now.

Johan Björnfot
Nov 30, 2012
(4 votes)

Shared blocks – IContent

Blocks is a new building block introduced in EPiServer CMS 7. A block can be used in several ways, it can be used as a “complex” property when modeling content types. It is also possible to create stand alone instances of blocks (shared blocks) that can be reused on content areas on other content  instances. Joel have written an good post about how to work with block properties (see ). In this post I am going to explain a bit about how to work programmatically with shared block instances.


In previous versions of CMS was pages (PageData) the only content type that the content repository (traditionally DataFactory) handled. In CMS7 this has changed so now content repository (IContentRepository) handles IContent instances. This means that the requirement for a .NET type to be possible to save/load from content repository is that it implements the interface EPiServer.Core.IContent.

There are some implementations of IContent built into CMS like PageData and ContentFolder (used to group shared block instances) and it is also possible to register custom IContent implementations.

If you look at BlockData though you will notice that it doesn’t implement IContent, how is then shared block instances handled? The answer is that during runtime when a shared block instance is created (e.g. through a call to IContentRepository.GetDefault<T> where T is a type inheriting from BlockData) the CMS will create a new .NET type inheriting T using a technic called mixin where the new generated subclass will implement some extra interfaces (including IContent).

That means that a shared block instance of T will implement IContent while an instance of T that is a property on a Page will not. If you attach a debugger and look at the instance returned from GetDefault<T> (where T is a type inheriting BlockData) you can see that the instance looks like:


Here we can see that the shared block instance have some extra fields for each interface that is mixed in.

So when working with shared blocks towards IContentRepository you can cast instance to IContent like below:
var repository = Locate.ContentRepository();

var sharedBlock = repository.GetDefault<ButtonBlock>(ContentReference.GlobalBlockFolder);
sharedBlock.ButtonLink = new Url("");
sharedBlock.ButtonText = "world";

//Since this is a shared block instance I can cast it to IContent
var content = sharedBlock as IContent;
content.Name = "MyButton";
var savedReference = repository.Save(content, DataAccess.SaveAction.Publish);

//I do not need to load it as ButtonBlock, here I load it as IContent
var loaded = repository.Get<IContent>(savedReference);
Debug.Assert(loaded.Name == content.Name);

Behavioral interfaces

As described above IContent is a required interface for content. In addition to IContent there are a number of behavioral interface that is optional for a content type to implement depending on if that behavior should be supported. Below is a list of the behavioral interfaces with a short description on what they contain/support:


Implement to supports versioning.


Implement to support multi language.


Implement to support categorizing.


Implement to support readonly access checks.


Implement to support access checks that is also possible to modify through IContentSecurityRepository.


Implement to support change tracking.


Implement to support modified tracking.


Implement  to ensure cached instances are immutable.


Implement to state that instance supports content folder.


Implement to control if the instance should implicitly be added to export package when referenced (e.g. from ContentArea).


Implement if is should be possible to route to instance (without partial router).

Suggested patterns

The suggested pattern when working with metadata on content is to cast the instance to the corresponding interface with as operator and then act depending on if the interface is implemented or not like in example below:

private string GetRoutingSegment(IContent content)
   IRoutable routable = content as IRoutable;
   return routable != null ? routable.RouteSegment : null;
And since types are dynamically subclassed you should not use exact type match as below to check a type
if (typeof(ButtonBlock) == content.GetType())

instead you can use operators is, as or method IsAssignableFrom like:

if (content is ButtonBlock) {/*code*/ }

var buttonBlock = content as ButtonBlock;
if (buttonBlock != null)
{ /*code*/ }

if (typeof(ButtonBlock).IsAssignableFrom(content.GetType()))
{ /*code*/ }
Nov 30, 2012


valdis Jun 13, 2013 11:09 AM

Old post, but helped to find a way to retrieve Modified date for the block :) thx

Krzysztof Morcinek
Krzysztof Morcinek Sep 6, 2013 09:19 AM

Very nice explanation. When you see this constructs in code, it is hard to believe why this magic has to happen.

Please login to comment.
Latest blogs
Frontend Hosting for SaaS CMS Solutions

Introduction Now that CMS SaaS Core has gone into general availability, it is a good time to start discussing where to host the head. SaaS Core is...

Minesh Shah (Netcel) | Jul 20, 2024

Optimizely London Dev Meetup 11th July 2024

On 11th July 2024 in London Niteco and Netcel along with Optimizely ran the London Developer meetup. There was an great agenda of talks that we put...

Scott Reed | Jul 19, 2024

Optimizely release SaaS CMS

Discover the future of content management with Optimizely SaaS CMS. Enjoy seamless updates, reduced costs, and enhanced flexibility for developers...

Andy Blyth | Jul 17, 2024 | Syndicated blog

A day in the life of an Optimizely Developer - London Meetup 2024

Hello and welcome to another instalment of A Day In The Life Of An Optimizely Developer. Last night (11th July 2024) I was excited to have attended...

Graham Carr | Jul 16, 2024