QA – Block rendering practices

A collegeau CMS developer asked me a maybe general but very important question the other day. Q; ‘When creating blocks, do you tend to put ‘structure’ markup in block views?’ My answer is it depends!

The Question

I’ve got an EPiServer best practice question, if you don’t mind.

When creating blocks, do you tend to put ‘structure’ markup in block views, put it in the template or is there another solution?

For example:

<section class='text-section'>
  div class='column-10 push-1'
    <p>This is the block markup</p> 

If we just put the <p> in the block view then it can be used in another page with a different layout (other than ‘column-10 push-1), but then we need to put the ‘structure’ markup in the template making it less flexible.

If we put the whole <section> in the block view then it would need extra options for how the ‘structure’ markup/classes are used, but the template can just contain a content area.

There are pros and cons of both. What do you guys find works best?

The Answer

As we say in dutch; ‘There are more ways that lead to Rome’. And for all there can be a valid reason. There is no such way as the best way for this. Best to know is that Episerver doesn’t force you to use certain HTML markup. And has a couple of features in place to lower down the amount of blocktypes you need and to asure the right content editor experience.


If, for some reason, the amount of blocktypes is growning, an important feature an Episerver CMS developer has to be aware off is that the CMS has the possibility to block the use of certain blocks on certain parts of the website. With the ‘AllowedType’ feature you can make sure a block is never used in an area or part of the website where it doesn’t ‘fit’. Read more on Episerver World.

Besides that the 3 most important features to know more about for this use case are;

Content area renderer

My advice is you start to know about the Content Area Renderers. Here is a link to the Alloy example of it. A Content Area Renderer is what is say it is; a renderer for content areas. With this feature you can manipulate the html output of the rendering of this propertytype and every item (block, page, asset, etc) in it. We have done plenty of more complex examples of whats done in the Alloy website. But the Alloy website is a very good start to learn more about this feature. The Content Area Renderer gives you really a lot of flexibility.

Display templates & PropertyFor

Episerver does also make use a lot of the DisplayTemplates functionality which is part of MVC. There are already plenty of blogsposts written about this subject. And an old articile about how propertyfor works written by Joel Abrahamsson is still very valid.

Display Options

Last but not least it’s important to know about display options. An editor can select which display option is used for rendering that block. The display options are available in the Content Area Renderer, so you can use them to create your rendering logic. The default content area renderers also make use of it.


I started this article with the fact that more solutions can be valid. But remember! Every Episerver project (or CMS project in general) starts with a good ‘datamodel’. The process of data modeling is something where you have to find the best balance between, editors flexibility and rendering output. That’s why it’s sometimes valid to re-use the block and sometimes introduce new blocks. Hopefully this article gives you a little of a direction and a good understanding on how flexibel Episerver is on HTML rendering and still make asure your editors have the right experience as well.

%d bloggers like this: