Migration Assessment Scan: Master Pages

Learn how to mitigate issues with Master pages during migration.

Overview

During migration, the default master page shouldbe set on all sites that are migrated. This ensures that the site will render once the migration is complete as the content migration will not have a dependency on any custom master pages. If you have custom master pages assigned to sites, you will need to set the Master Page property on the new site after the migration has completed.

Data Migration

Important: Custom master page files (*.master) shouldn't be migrated to the new platform. The setting on the destination site will be set to the default master page. This process ensures the site will render after the migration.

Preparing for Migration

Review the report and determine where you can move away from custom master pages before you migrate. Plan and understand what post migration work will be necessary to use the customized file moving forward.

Post Migration

If you decide to continue using the customized master page on the new platform, you will need to apply the master page setting and validate your customizations work on the new platform.

Scan Result Reports

NonDefaultMasterPages-detail.csv    This scan report contains all the sites that have a custom master page applied.

Column

Description

SiteId

Unique identifier of the impacted site collection.

SiteURL

URL to the impacted site collection.

SiteOwner

Owner of the site collection.

SiteAdmins

List of people listed as site collection administrators.

SiteSizeInMB

Size of the size collection in megabytes [MB]

NumOfWebs

Number of webs that exist in the site collection.

ContentDBName

Name of the content database hosting the site collection.

ContentDBServerName

SQL Server hosting the content database.

ContentDBSizeInMB

Size of the content database hosting the site collection.

LastContentModifiedDate

Date/Time the site collection had content modified.

TotalItemCount

Total number of items found in the site collection.

Hits

Number of requests logged for the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.

DistinctUsers

Number of distinct users that have accessed the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.

DaysOfUsageData

Number of days the usage logging service retains data. This provides context for Hits and DistinctUsers. For example, if this is 14 days, the Hits and DistinctUsers data is for the last 14 days.

WebUrl

Url to the subsite that has the master page setting configured.

WebTitle

Title of the impacted subsite.

MasterPageUrl

Server relative path to the master page referenced by the MasterPageUrl property.

CustomMasterPageUrl

Server relative path to the master page referenced by the CustomMasterPageUrl property.

ScanID

Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

Expand your skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×