Tip of the week: The "ultimate" site structure setup

Note: this post is over a year old, it's very likely completely outdated and should probably not be used as reference any more. You have been warned. :-)

There's a saying in Holland that translates to (literally): "A good beginning is half the work". While that is a bit of an exaggeration, starting with a good structure to your new Umbraco site can be very important.

Last Friday I was skyping with my friend Yannick and he was having a little trouble with redirecting the home node of his site and using my search engine sitemap package. After some back and forth we eventually came to the ultimate setup.

Basically, there will always be two nodes: "Site settings" and "Home". The settings node is there so a few site-specific settings (like the Google Analytics account) can be stored. It also helps preventing editors from being able to create documents of just any type. By default, under the "Content" node you can create nodes of all kinds and generally, you want to very much limit what they can create to prevent the site from becoming a mess.

You can see an example of this structure in the following image:


The "Site" node has the hostname(s) of the site set to it, although it doesn't have to have that. Umbraco will present the first node that it finds in the content tree as the homepage of the site.

I've redirected the "Site" node to the "Home" node so that the correct page will be shown to people entering the site. Later on in the development of your site, I'll be using Umbraco's NiceUrl method to point to pages in my site. Some of those NiceUrl calls go to the "Home" page. This will currently point to "/home".

If you've setup your site to redirect using the umbracoRedirect property, you will have created a 302 redirect from "/" to "/home". This is not what you want for two reasons:

  1. search engines don't like that there are two pages in the site with the exact same content
  2. search engines know that a 302 redirect means that it's temporary, so they will keep expecting that the "/" and the "/home" pages are supposed to be different

Additionally, you will be faced with another, more immediate couple of problems in Umbraco:

  1. the altTemplate mechanism controlled by the 404handlers.config gets confused and only works if you prefix the template name with "/home", which would cause a problem with the search engine sitemap package that I mentioned earlier
  2. you are suddenly unable to save XSLT files from the built-in editor in Umbraco

This is easily fixed though. On the "Site" node, I've put a property of the Content Picker type with the alias of umbracoInternalRedirectId that will not actually do a redirect, but will render whatever node you pick instead of the current node. Logically, I have picked the "Home" node.

This leaves you with a bit of a problem still, as Umbraco's NiceUrl method still produces links to "/home". To solve this, you can just do a simple urlRewrite and make the "/home" call always do a 301 (permanently moved) redirect to "/". Just the way search engines like it. Be careful: this will cause an infinite loop if you do it while the umbracoRedirect property is still on there, only do this with the umbracoInternalRedirectId property.

The urlRewrite config looks like this (note the "$" at the end of "home" is there to make sure that if you want any nodes under your home page, they won't be rewritten as well):

<add name="home"
virtualUrl= "^~/home$"
redirectMode="Permanent" />

And there you have it, the "ultimate" site structure for you to start your site with. Google is happy, Umbraco is happy (it will save your XSLT files again), everybody is happy!

That being said, this will probably be my last blog post for this year. Happy holidays and see you next year.

Sebastiaan Janssen

Dutch guy living in (and loving) Copenhagen, working at Umbraco HQ. Lifehacker, skeptic, music lover, cyclist, developer.


22 comments on this article

Avatar for Ismail Mayat Ismail Mayat | December 20 2010 09:49
I usually have global site settings as a separate tab on the home page so things like site name, google analyics etc can be stored there. Was there a specific reason for having the settings as separate node?



Avatar for Sebastiaan Janssen Sebastiaan Janssen | December 20 2010 09:54
Hey Ismail,

Well yes, first of all they are site settings, not just homepage settings... ;)
But better reasons are that I tend to do a lot of multisite solutions, in which you have to make these site nodes anyway.
Also, as explained in the post, I don't want my editors to be able to add a, I don't know, "gallery image node" right under "Content". As said, Umbraco allows you to add just any document type straight under the Content node. By forcing my editor to start at the "Site Settings" node, I can also enforce what types of documents can be created under it.

Avatar for Ismail Mayat Ismail Mayat | December 20 2010 10:35
Ah cool makes sense.



Avatar for Sander Houttekier Sander Houttekier | December 20 2010 11:22

i believe you will run into another problem when users start renaming nodes then?
If your client renames Home into Homepage your url rewrite won't work.

could this be a solution to that :
adding a property to the home node with that, and set it to "Home" if the client would rename the node, the url it produces will stay /home...
so your rewrite will keep working.

Avatar for Pete Duncanson Pete Duncanson | December 20 2010 11:59
Nice to see someone else who is a fan of a seperate site settings node. This is a nice way around it, I normally have a home and then site settings on the same level after it, this way though like you say give greater control to what doc types you can create. Nice work Sebastiaan.


Avatar for Fredrik Sewen Fredrik Sewen | December 20 2010 12:08
Sebastiaan, nice article.

I usually end up doing the same as you are describing. Although I'm not too keen about this solution, since

1) As Sander describes, it takes some of the control away from the Umbraco backend. When renaming/changing you have to change in the filestructure (rewrite-config-file).
2) I've heard from SEO-experts that it's never good to start with a 301-redirect. I think the reason is that the most natural in-link to your site is the www.domain.com and when google is "mapping" this it's not good if it's a 301-redirect.

But I havn't found a better solution so until i know better it's a great tip and tutorial!

Happy holidays,


Avatar for Sebastiaan Janssen Sebastiaan Janssen | December 20 2010 12:15
Yes, that could be problem and your solution is great. Unless of course they want the homepage to have a different URL than /home. This is a rare case though.

I don't start with a 301 though, the internal "redirect" doesn't do an actual redirect, just renders the home page instead of the "site settings" page. The only redirect comes when you click on the "home" node.

Avatar for Chris Houston Chris Houston | December 20 2010 14:30
Hi Sebastiaan,

We do exactly the same as you, however we prefer not to use the 301 and we usually put in a bit of logic on our XSLT that generates the navigation so that the home page link goes to the root of the site instead of /home that way avoiding the 301 re-direct entirely.

Happy Christmas to you too!


Avatar for Sebastiaan Janssen Sebastiaan Janssen | December 20 2010 14:32
Yes, I usually just harcode "/" in my XSLT files, but I figured it would be easier not to have to think about that. Also: the editor can make links to any page, including the homepage, which would lead to an unexpected link to "/home".

Avatar for Anthony Anthony | December 21 2010 09:39
Hi Sebastiaan,

Thanks for this great contribution. I have to create a multilangue website.

How could I implement your site structure for a multilanguage site?

- site
- nl-Be
- home
- klanten
- ...
- fr-BE
- home
- clients
- ...



Avatar for Yannick Yannick | March 24 2011 13:52
Have you adapted your Cultiv sitemap to support this already?

Avatar for Sebastiaan Janssen Sebastiaan Janssen | March 24 2011 14:28
Yes, support for this has always been built in.

Avatar for Jeroen Breuer Jeroen Breuer | March 31 2011 12:01

I'm using this setup now with a multilanguage site and it works perfect! First I set different host names and internal redirects to the correct urls. Than I added the url rewrite which uses "^~/" so it looks at the host name. This way if I go to website1.com/home it's redirected to website1.com with an internal redirect to the home page of website1 and if I do the same for website2 it get's redirected to the home of website2.


Avatar for Anthony Candaele Anthony Candaele | May 10 2011 19:19
Hi Sebastiaan, thanks for the great article. I'm configuring my first Umbraco site using the structure you describe in this article. You speak about this Site Settings document type storing site settings data like Google Analytics script. What other kinds of data besides Site Name and Google Analytics script are stored in the Site Settings?

Thanks for the advice,


Avatar for Sebastiaan Janssen Sebastiaan Janssen | May 11 2011 08:28
That really depends on the site that I'm building. Most of the time, these are enough. Generally, it would be things that are used throughout the whole site (and are therefore not page-specific).

Examples include a logo that needs to change from time to time, I've used it for the google maos api key.. those sorts of things.

Avatar for Anthony Candaele Anthony Candaele | May 11 2011 15:49
Hi Sebastiaan,

Yesterday I implemented the site structure suggested in this article for a new website I'm working on. Everything works fine and I'm glad I've learned a new technique for building Umbraco websites.

Thanks for sharing your knowledge and expertise


Avatar for Vlax Vlax | January 25 2012 03:05
Hi I have a similar question like Anthony, how can you make this work in a multilingual site?

Avatar for Be_bert Be_bert | May 29 2012 16:22
I use this method too. But in stead of putting a URL rewrite in the config file, I use the 'umbracoUrlName' property. On the homepage I set it on "/".

In a 1 site,1 language installation it works like a charm.

Avatar for Sebastiaan Janssen Sebastiaan Janssen | May 29 2012 19:46
Yup, that'll work as well, however, it doesn't do a 301 but a 302 (temporary) redirect so search engines will try to index it over and over again.

Avatar for Be_bert Be_bert | May 30 2012 12:39
In the rare case the url would end up somewhere in your site it would do a 301. The point here however is to never see the url 'something.com/home'.

By using the 'UmbracoUrlName' property "something.com/home" would never show up in the navigation and the 301 wouldn't occur, or would it?

I imagine in the backend the settings node just shows the 'home' node content on his non redirected url and the navigation just shows a url linked to another node ('by accident').

Avatar for JB JB | July 19 2012 12:03
Why wouldn't you use umbracoInternalRedirectId and just make '/' internally redirect to /home instead of doing a 301?

Avatar for Anthony Anthony | November 14 2012 18:04
This is exactly what I used to do... up until today.

There was 1 major thing to consider... The 301 URL Tracker package.

When settings a redirect for the home node, the user will always see /home/ in the browser address bar. We only want the user to see /

The uComponents 301 redirect seems to have the same issue.

Personally, I don't mind seeing /home/. But clients for some reason don't like it.

So the structure we are using now is:

Site (renders the home page)
- Some Page
- Some Page
- Some Page
- Site Configuration
- Some sub node for configuration