February 7, 2013

How to edit 2013 Seattle and Oslo Master pages


SharePoint 2013 has a fancy new system called Design Manager that is there to help making pages from scratch much easier than in SP2010. However if all you want to do is modify the Seattle or Oslo default master pages and, say, add a footer then all the Design Manage seems to do is obscure what should be a simple process. But it is possible to edit these master pages! Here is how...

1) You must have Design Manager enabled. To do this make sure you enable 'SharePoint Server Publishing' & 'SharePoint Server Publishing Infrastructure' features in both the Site Collection & Site Features.

If like me you get errors and cant enable these features in the browser then try these command lines:
Enable-SPFeature -Identity PublishingSite -URL http://siteurl -Force
Enable-SPFeature -Identity PublishingWeb -URL http://siteurl -Force


2)  In your site open: Site Settings > Master pages and page layouts.

3) Find seattle.html  and open "Edit properties".

4) Uncheck "Associate File".

SharePoint should now allow you to edit the master file directly without throwing errors.

A Gotcha...

If you are including your own .css file make sure the path is correct, from trial-and-error it looks like SharePoint will not render the tag if it cant find the file, so it will give the impression that you are unable to save the .html file. ie: look like the above instructions have not worked.
 <SharePoint:CssRegistration Name="/Style Library/blah.css" runat="server" /> 

If you find this helpful please share a comment. Thanks!

10 comments:

  1. thanks, i tried and finally i was able to save my modified master page

    ReplyDelete
  2. Thank so much!!! There are lots of suggestions from many sources but this one is the only one that really solve the problem... Once again, my gratitude for you, taking time to post this solution!

    ReplyDelete
  3. I edited the oslo.html file to add a footer to all pages. it works great! However, when I open the oslo.html file again to edit the links in my footer, the code is no longer showing between the divs, but the footer is still displaying on the site. How can this be? Is the code stored somewhere else after it is committed to the oslo.master?

    ReplyDelete
  4. Thank you! I followed your suggestions to add a footer (sitemap) to the pages and it worked perfectly. However, when I opened oslo.html the next day to edit the links in my footer, the html code was no longer showing between the divs, but the footer is still displaying on the pages. How can this be? Is the code stored somewhere else once it is committed to the oslo.master?

    ReplyDelete
  5. oh!! You saved my life. Though many of them posted many solutions to create a copy of the master page and then customize that, none of them worked for me. The solution provided by you was pretty basic and smart way. Thanks for posting this!!!

    ReplyDelete