Best Practice for Promoting Nested Subsites to Root Level in SPO (4383312)

Return

Feedback Submitted

Did this article solve an issue for you?

Select Rating

Title

Best Practice for Promoting Nested Subsites to Root Level in SPO
Description

When attempting to promote multiple nested subsites to root-level site collections in SharePoint Online, users may encounter failures, broken parent-child relationships, or incomplete migrations. These issues typically occur when subsites are promoted out of order or when the hierarchy is not properly accounted for during migration.
Cause

SharePoint subsite structures maintain hierarchical dependencies between parent and child sites. Promoting higher-level subsites before their child sites can break these relationships, leading to failures or inconsistencies. Additionally, incomplete discovery of the site structure may result in missing subsites during the promotion process.
Resolution
Follow a deepest-level-first promotion strategy to ensure proper hierarchy handling:
1. Discover Full SharePoint Structure
2. Promote Subsites Starting from the Deepest Level
Example Structure:

/sites/Rootsite (Parent)

/sites/Rootsite/SubsiteA (Level 1)

/sites/Rootsite/SubsiteA/SubsiteA1 (Level 2)

/sites/Rootsite/SubsiteA/SubsiteA1/SubsiteA1a (Level 3)

/sites/Rootsite/SubsiteA/SubsiteA1/SubsiteA1a/SubsiteA1a1 (Level 4)

Correct Promotion Order:
1. For Each Subsite:
2. Reference Documentation:

Feedback Submitted

Did this article solve an issue for you?

Select Rating

Title