Episerver Troubleshooting

As developers, we all hit hurdles from time to time.  This section covers advice and battle proved techniques to help you figure out what’s gone wrong in your website.  If you are sat in front of your PC now with a broken build and you are unsure what to do.  I would recommend reading the articles in the Recommend Reading section to try and get some inspiration of what to try and where to look.  You can also ask me, I get emailed every week by people from all over the world and I generally respond to every request.  If you are still stuck, or can’t be arsed to email a complete stranger, you can also ask your question on the Episerver forums, as the Episerver community is generally pretty good and someone may answer for you.  Stackoverflow is always available.


1. 8 Tips To Help You Trouble Shoot Episerver Issue
2.vTop Tips To Get An Existing Episerver Project Up And Running
3. Common Mistakes People Make On Their Episerver Build
4. How To Debug An Episerver Scheduled Job or Initialization Module
5. The Easiest Way To Add An Error Handler Into Your Epi Site

Latest Episerver Troubleshooting Tips

Activation error occurred while trying to get instance of type EPiDashboardController Exception

I've had this error a few times, usually when trying to install an exisiting Episerver website: 2016-11-21 14:45:15,586 ERROR [82] *******.Application_Error - Error caught in global.asax EPiServer.ServiceLocation.ActivationException: Activation error occurred while trying to get instance of type EPiDashboardController, key "" ---> StructureMap.StructureMapException: StructureMap Exception Code: 207 Internal exception while creating Instance 'bfa8cfc3-aae9-4405-bae7-86e03db460b8' of PluginType EPiServer.Shell.ViewComposition.IViewManager. […]

Getting a 503 Error Service Unavailable When Installing Episerver

Over the years, this issue has happened to me a few times and I always seem to forget the cause and spend 10-20 minutes remembering. This usually happens when I start working with a new client on a brand new laptop. After getting the solution to build, when I try to view the site in […]

Episerver Uncaught TypeError: Cannot read property 'label' of undefined(…)

Recently, I was tried upgrading my sample site from 7 to 10. Everything looked like it had upgraded and worked as expected until I tried to load the editor. When I tried to view the editor nothing loaded! Using Chrome's, 'Inspect' option, within the console I saw this error: In How To Render Custom HTML […]

How To Log Into Episerver When You Don't Know A User or Password

This article is a continuation of Top Tips To Get An Existing Episerver Project Up And Running. Often when I start at a new company, I won't have a log-in to get access to Episerver and I'm left to my own devices to get started. In today's guide, I'm going to cover some of the […]

Top Tips To Get An Existing Episerver Project Up And Running

I work frequently with numerous clients on different projects and the first big hurdle in being able to make any impactful changes is being able to get the existing site up and running on your development machine. In some instances, you might be working with an existing team and they can help you get everything […]

How To Write Log4Net Logs Into A Different File In Episerver

When we install Episerver, the Log4Net package also gets installed. Having a pre-configured Log4Net file means that writing errors and information toa log file information is simple. As your website grows, only having a single log file can be problematic.. especially when you need to fix errors quickly. In a lot of situations, it sometimes […]

Episerver Property Is Always Null

This post is a short and simple one to try and prevent people wasting precious time trying to figure out why your Episerver property is always returning null. When you start to create properties on your pages and blocks, it's easy to miss keywords or attributes when you're typing in a new property.  If you […]

Common Mistakes People Make On Their Episerver Build

Over the years, I have worked on some really good projects and I've also worked on what could have gone a lot better.  Hindsight is a beautiful thing to have, but without learning from mistakes, you'll never design world class solutions. With that in mind, in today's guide, I'm going to cover some common mistakes […]

How To Pass Parameters and Debug Route Data In Episerver

Trying to pass parameters between pages and blocks in Episerver seems to give a lot of people headaches and can be the root of a lot of frustration. One of the main issues I see a lot of people struggle with is understanding the difference between standard MVC Routing and Episerver routing. I can hold […]

Can not upload an image file in EPiServer?

When you start work on a new Episerver project, at some stage a content editor will want to upload an image into Episerver.  When you try to upload an image using the Media Library uploader, you will see a failed upload message. Why does this happen? By default, no built-in media types exist in Episerver, […]

How To Debug An Episerver Scheduled Job or Initialization Module

I overheard a colleague complaining about how he had wasted his whole afternoon tediously trying to debug an issue we had in an InitializationModule.  We had a standard MVC web project and he was hitting Debug in Visual Studio, firing up Cassini and nothing happened. This is to be expected as things like an Initialisation module, actually […]

8 Tips To Help You Trouble Shoot Episerver Issues

I find that debugging and fixing errors probably takes up around 25% of my day.  Sitting in front of a PC not knowing why something is broken is very annoying, to say the least.  Over the years, I have, unfortunately, had to come up with and discover many different ways to debug.  This article is going […]

Help! We keep adding new projects to our solution and accidentally keep upgrading Episerver!

Recently, Episerver have moved to a bi-weekly release schedule, which is great as you can constantly upgrade.  The bad side of this is, if you're working on a large project with 7+ people, when someone adds a new project, goes to Nuget installed Epi.Core and the version has changed, everyone has to upgrade everything.  If […]

EPiServer 7.5 Visual Studio Warning : Where has the episerver.config and EPiServerFramework.config gone?

If you saw my last post about installing EPiSever 7.5 using the new Visual Studio Project template, I thought I'd share my experiences so far.   After I installed the site, I went in search for the epi.config and after some head scratching became puzzled that I couldn't find it.  After a lot of 'research' I found out […]

EPiServer 7 : Are you getting a ClientResources\ClientResources\packages.config error when logging in ?

After performing a pull from our SCR I got the following error when trying to log into the EPiServer editor.   After a lot of head scratching I figured out the issue was with my VPP folder, specifically the Nuget packages.  To fix the issue, first check your .config is pointing to the correct area […]

EPiServer 7 : The trust relationship between the primary domain and the trusted domain failed.

After installing the Alloy tech demo site, I've run into this error a few times on my first install when trying to log into the editor. Here are a few tips to try and solve it: 1. Make sure you are using the right user-name and password.  I have found that when I'm using my […]

Episerver : CS1519: Invalid token ',' in class, struct, or interface member declaration error

This is a quick one that will, hopefully, save someone out there an hour or two! Recently I was doing a deployment and I came across this error: I tried all the usualy IISREST, clean the temp .NET files a reboot but nothing worked until I realised what had happened... I did some cleaning on […]

Episerver : The Easiest Way To Add An Error Handler Into Your Epi Site

EPiserver uses Log4Net as its default error handler.  The benefit of Log4Net for a developer is that you can also use it with very minimal configuration.  Log4Net is a really simple and flexible error handling system which is far better to use instead of having to come up with a custom solution yourself, or, importing […]