Home

How to Set a SharePoint Server 2016 v16 Master Page as the Master Page

%3CLINGO-SUB%20id%3D%22lingo-sub-183851%22%20slang%3D%22en-US%22%3EHow%20to%20Set%20a%20SharePoint%20Server%202016%20v16%20Master%20Page%20as%20the%20Master%20Page%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-183851%22%20slang%3D%22en-US%22%3E%3CDIV%20class%3D%22external-social-share%20ember-view%22%3E%3CDIV%20class%3D%22reader-post-publishing-cta%20reader__grid%20p4%22%3E%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3C%2FDIV%3E%3C%2FDIV%3E%3CDIV%20class%3D%22reader-cover-image--wrapper%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fmedia%2Fgcrc%2Fdms%2Fimage%2FC4D12AQEcaCHAcVVb1A%2Farticle-cover_image-shrink_423_752%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DLydr7EMnEN5lJuH9yQoAfD-VJlx_T7Ehxx13E4L_YYI%22%20border%3D%220%22%20alt%3D%22%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22reader-cover-image--wrapper%22%3E%26nbsp%3B%3C%2FDIV%3E%3CDIV%20class%3D%22relative%20reader__grid%22%3E%3CH1%20id%3D%22toc-hId-1819950889%22%20id%3D%22toc-hId-2020531684%22%3EWhy%20isn't%20my%20custom%20SharePoint%202016%20master%20page%20listed%20in%20the%20drop-down%20selections%3F%3C%2FH1%3E%3CP%3EDarian%20Glover%2C%20MCTS%2C%20CISSP%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3E%3CSTRONG%3EHow%20to%20Set%20a%20SharePoint%20Server%202016%20v16%20Master%20Page%20as%20the%20Master%20Page%3C%2FSTRONG%3E%3C%2FP%3E%3CDIV%20class%3D%22ember-view%22%3E%3CDIV%20class%3D%22reader-article-content%22%3E%3CP%3EMy%20current%20engagement%20has%20me%20responsible%20for%20the%20architecture%20of%20a%20SharePoint%20publishing%20site%20collection%20that%20is%20migrating%20from%20SharePoint%202010%20to%202016.%20It%20is%20quite%20a%20jump%20with%20many%20challenges.%20This%20article%20documents%20the%20workaround%20my%20team%20found%20to%20a%20vexing%20issue-%20after%20creating%20a%20brand%20new%20master%20page%20in%202016%20using%20Design%20Manager%2C%20the%20master%20page%20did%20not%20show%20up%20as%20an%20option%20under%20Site%20Settings%20%26gt%3B%20Master%20Page.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQF3SO8zrtIUfA%2Farticle-inline_image-shrink_1500_2232%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DzNVV7k2_4vbn1R_gqEFA7TWw8Lu10mPA5oycJg6bI1M%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EThe%20page%20was%20created%20in%20the%20same%20site%20collection%20using%20Design%20Manager.%20And%20it%20was%20published.%20And%20with%20the%20correct%20content%20type.%20And%20in%20the%20site's%20master%20page%20gallery.%20But%20curiously%2C%20the%20only%20differences%20between%20this%20new%20custom%20master%20page%20and%20the%20Seattle%20and%20Olso%20pages%20is%20the%20UI%20version%20and%20that%20it%20is%20an%20ASP.NET%20Master%20Page%20with%20no%20option%20to%20set%20it%20as%20a%20plain%20Master%20Page.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQH1LExpoQSLRg%2Farticle-inline_image-shrink_1500_2232%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DRjYu8Lk1_eoeYX6Xk6Q1RlqTgMBcCgiCyOFA8dLbYzI%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%26nbsp%3B%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQEcpvrR49m9yA%2Farticle-inline_image-shrink_1000_1488%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DJZRatWEgVoNMnuLcmT9tkNQ-20lgrD2mTx-XuAjX6Rg%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%26nbsp%3B%3C%2FDIV%3E%3CP%3EAttempts%20to%20set%20the%20page%20as%2015%20or%204%20compatible%20fail%20because%20master%20pages%20are%20not%20intended%20to%20ever%20go%20backwards%20in%20the%20SharePoint%20evolution%20cycle.%20Though%20I%20am%20sure%20at%20least%20one%20customer%20has%20asked%20Microsoft%20about%20performing%20a%20reverse%20migration%2Fdowngrade.%20Any%20attempt%20to%20set%20a%20v16%20master%20page%20as%20v15%20compatible%2C%20let%20along%20attempting%20to%20use%20it%20on%20a%20version%20of%20SharePoint%20prior%20to%202016%20will%20lead%20to%20the%20Sorry%20Error.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQFrS8YFvovY8w%2Farticle-inline_image-shrink_1000_1488%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3D8O7aMVDuGoVcKZDtTu8ImlrnbpwOc9heub_FNTCWK4I%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%26nbsp%3B%3C%2FDIV%3E%3CP%3ESo%20how%20did%20we%20work%20around%20this%20issue%3F%20A%20shout%20out%20goes%20to%20Nicole%20who%20suggested%20using%20SharePoint%20Designer%20to%20set%20the%20custom%20master%20page%20as%20the%20default%20master%20page.%20It%20not%20only%20worked%20like%20a%20charm%2C%20but%20also%20provided%20useful%20information%20the%20web%20UI%20lacked.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CBLOCKQUOTE%3E%3CEM%3EThe%20master%20page%20you%20have%20chosen%20is%20intended%20for%20sites%20with%20a%20version%2016%20user%20interface.%20This%20site's%20user%20interface%20is%20currently%20set%20to%2015.%20Would%20you%20like%20to%20change%20it%20to%20version%2016%3F%3C%2FEM%3E%3C%2FBLOCKQUOTE%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQF_T6GNauMAIg%2Farticle-inline_image-shrink_1500_2232%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DTIIJ0RSS5UweuE148uqe8UWOcYLzc78qO0YSa6hnXVw%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%26nbsp%3B%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fmedia.licdn.com%2Fdms%2Fimage%2FC4D12AQGNsExc_Lq9IQ%2Farticle-inline_image-shrink_1500_2232%2F0%3Fe%3D2123193600%26amp%3Bv%3Dbeta%26amp%3Bt%3DmEAcxUfgrbI1I3Qsgb-42aD2NDvScN9bpYtIp2AS5bg%22%20border%3D%220%22%20%2F%3E%3C%2FDIV%3E%3CDIV%20class%3D%22slate-resizable-image-embed%20slate-image-embed__resize-full-width%22%3E%26nbsp%3B%3C%2FDIV%3E%3CP%3ESelecting%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3CSTRONG%3EYes%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3C%2FSTRONG%3Eand%20taking%20the%20user%20interface%20up%20to%2016%20allowed%20use%20of%20the%20new%202016%20custom%20master%20page.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FDIV%3E%3C%2FDIV%3E%3C%2FDIV%3E%3C%2FLINGO-BODY%3E%3CLINGO-LABS%20id%3D%22lingo-labs-183851%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3E2016%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EDeveloper%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3ESharePoint%20Server%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Darian Glover
Occasional Contributor
 

Why isn't my custom SharePoint 2016 master page listed in the drop-down selections?

Darian Glover, MCTS, CISSP

 

How to Set a SharePoint Server 2016 v16 Master Page as the Master Page

My current engagement has me responsible for the architecture of a SharePoint publishing site collection that is migrating from SharePoint 2010 to 2016. It is quite a jump with many challenges. This article documents the workaround my team found to a vexing issue- after creating a brand new master page in 2016 using Design Manager, the master page did not show up as an option under Site Settings > Master Page.

 

 

The page was created in the same site collection using Design Manager. And it was published. And with the correct content type. And in the site's master page gallery. But curiously, the only differences between this new custom master page and the Seattle and Olso pages is the UI version and that it is an ASP.NET Master Page with no option to set it as a plain Master Page.

 

 
 

Attempts to set the page as 15 or 4 compatible fail because master pages are not intended to ever go backwards in the SharePoint evolution cycle. Though I am sure at least one customer has asked Microsoft about performing a reverse migration/downgrade. Any attempt to set a v16 master page as v15 compatible, let along attempting to use it on a version of SharePoint prior to 2016 will lead to the Sorry Error.

 

 

So how did we work around this issue? A shout out goes to Nicole who suggested using SharePoint Designer to set the custom master page as the default master page. It not only worked like a charm, but also provided useful information the web UI lacked.

 

The master page you have chosen is intended for sites with a version 16 user interface. This site's user interface is currently set to 15. Would you like to change it to version 16?
 
 

Selecting Yes and taking the user interface up to 16 allowed use of the new 2016 custom master page.