Others

How to Fix a Custom SharePoint Master Page That Does Not Apply

Elise Williams Oct 22, 2026 868 views

Question details

The user needs to troubleshoot a custom SharePoint master page that is published and visible in the list but fails to apply as the site master page.

How to Fix a Custom SharePoint Master Page That Does Not Apply

Product: Microsoft SharePoint
Device & OS: not provided
Scenario: Applying a custom branding or layout to a SharePoint site collection.
Observed behavior: The custom master page appears in the site's master page settings list but does not take effect after being selected and saved.

Before you start

Ensure you have Site Collection Administrator permissions, as these privileges are required to fully approve and apply custom master pages across a SharePoint site.

Solution 1Recommended

Verify Master Page Configuration and Approval Status

Ensure the master page is fully compatible, published as a major version, and properly approved so it can be rendered by the SharePoint site.

In many cases, a master page will show up in the selection list if it is uploaded, but it will not actually apply to the live site unless it has completed the strict SharePoint publishing and approval workflow.

Additionally, any syntax errors in custom HTML snippets can silently block the master page from rendering.

Check SharePoint version compatibility

Verify that your custom master page was built for your specific version of SharePoint. An older master page version may not render correctly in a newer SharePoint environment.

Publish as a major version

Navigate to the Master Page Gallery (Site Settings > Master pages and page layouts). Select your custom master page, click 'Files' in the ribbon, and choose 'Publish a Major Version'.

Approve the master page

If Content Approval is enabled on the gallery, select the master page file, go to the ribbon, and click 'Approve/Reject' to mark the file as 'Approved'.

Verify system vs. site master page settings

Go to Site Settings > Master Page. Ensure you are applying the custom design to both the 'Site Master Page' (for publishing pages) and the 'System Master Page' (for administrative forms and lists) as needed.

Verify Master Page Configuration and Approval Status

Check for snippet errors: If you used the Design Manager to generate the master page from an HTML file, return to the Design Manager to ensure the preview renders without any snippet or markup warnings.

Solution 2

Seek Specialized SharePoint Developer Support

Because custom master pages involve complex coding and server-side configurations, persistent issues should be directed to specialized support communities.

Free Microsoft Office alternative

Boost Your Daily Document Productivity with WPS Office

While managing SharePoint requires navigating complex site configurations, your everyday document editing should be simple. WPS Office offers a highly compatible, free, and lightweight alternative to Microsoft Office, perfect for seamless word processing, spreadsheets, and presentations.

1. Download the software: Visit the official WPS Office website and download the free installer for your operating system.
2. Open existing files directly: Launch WPS Office and open your .docx, .xlsx, and .pptx files seamlessly without losing any formatting or data.
3. Edit and save with ease: Utilize the comprehensive editing tools to manage your documents, saving them locally or to the cloud.

Fully compatible with Microsoft Word, Excel, and PowerPoint file formatsLightweight application that installs quickly and runs smoothly on PC and MacFamiliar and intuitive user interface for a zero-learning-curve migrationBuilt-in PDF editing, document conversion, and cloud collaboration tools

microsoft office alternative - wps office

Frequently Asked Questions

Why is my SharePoint master page not appearing in the selection list at all?

The file must be properly checked in and published as a major version before it becomes available in the Site Settings master page list. Drafts will only be visible to the user who uploaded them.

What happens if there is a coding error in my custom snippet?

If a custom HTML snippet contains syntax errors, SharePoint's Design Manager may fail to convert it properly, causing the site to revert to the default master page or display an unhandled exception error page.

Can I apply a custom master page to all subsites automatically?

Yes. When you select a master page in the Site Settings, check the box labeled 'Reset all subsites to inherit this site master page setting' before clicking OK. This forces all child sites to inherit the new design.

Office Quick Solutions