all things Sitecore related

Sitecore Knowledge Base Article 747661, Reference number 423248 – Another Solution

By on January 2, 2015 in Sitecore with 0 Comments

Hi there,

I’m currently working on a Sitecore 7.5 project, which currently stills uses webforms instead of Sitecore MVC because of legacy reasons. One thing I’ve noticed was the following error I got every time when the Sitecore instance was activated:

Error Message: ERROR Failed to create instance Sitecore.Services.Infrastructure.Web.Http.DefaultRouteMapper, Sitecore.Services.Infrastructure

At first I didn’t know where this was coming from, but just at the end of 2014 (just 3 days ago, on December 30th 2014), Sitecore Support wrote a Knowledge Base article on it:

The issue occurs because the Sitecore.Services.Client service layer fails to create the route mapper specified in the configuration file. The route mapper is used for mapping service routes to ASP.NET MVC and ASP.NET Web API layers.

In that Knowledge Base article ( they provide a solution, by saying, just comment out the following setting in the /App_Config/Include/Sitecore.Services.Client.config file:

<setting name=”Sitecore.Services.RouteMapper” value=”Sitecore.Services.Infrastructure.Web.Http.DefaultRouteMapper, Sitecore.Services.Infrastructure” />

Since in my solution I don’t want to adjust Sitecore’s config files if I don’t have to, I was curious if I could use the build-in patching functionality of Sitecore, which is absolutely great and makes the whole configuration stuff in Sitecore very flexible.

So here’s my solution in what you could do, in order to get rid of the error that shows up every time in your Sitecore 7.5 solution. Just create a z_custom.config file and copy in the following:

<configuration xmlns:patch=”” xmlns:x=””>
    <!– Remove the following setting in Sitecore because of Sitecore.Services.Client fails to create the route mapper when launching
    Error Message: ERROR Failed to create instance Sitecore.Services.Infrastructure.Web.Http.DefaultRouteMapper, Sitecore.Services.Infrastructure
    More info:
    Reference number: 423248
  <setting name=”Sitecore.Services.RouteMapper”>


By just patch:delete the specified setting, we remove the setting also.

If you now go to http://[YOUR INSTANCE]/sitecore/admin/showconfig.aspx, you’ll see that the setting has been removed.


Make sure you name you’re include config file with a z_ or something so that it will be patched after the inclusion of the Sitecore.Services.Client.config file

Happy Sitecore trails



About the Author

About the Author: I'm a Freelance and passionate Sitecore Developer living in The Netherlands. Running my own company Kayee Internet & Software Oplossingen. I am specialized since 2008 in Sitecore and Umbraco implementations. Sitecore MVP since 2011. Founder and member of the Dutch Sitecore User Group. You can follow me on twitter: @kayeeNL. My website: .


If you enjoyed this article, subscribe now to receive more just like it.

Post a Comment

Your email address will not be published. Required fields are marked *