Merge pull request #865 from reshmee011/OOB_sitedesign

new sample script to apply OOB site design

Author: pkbullock

scripts/spo-apply-OOB-sitedesign/README.md

@@ -0,0 +1,87 @@
+# Apply Out-of-the-Box SharePoint Site Designs to Existing Sites
+
+## Summary
+
+What if you need to apply Microsoft's out-of-the-box site designs to existing sites using automation? The PnP PowerShell, CLI for M365 and other PowerShell module cover applying custom site designs only. We can leverage a PowerShell hack using REST API calls to achieve this functionality. Thanks to Arash Aghajani who pinpointed on feasibility and requested for it to be natively available within PnP PowerShell. However the implementation with PnP PowerShell uses CSOM and does not the option to apply out of the box site design.
+
+---
+
+## The Challenge
+
+Microsoft provides several useful out-of-the-box site designs like:
+- **Project Management** - Adds project-related lists and libraries
+- **Training Portal** - Sets up training-focused site structure
+- **Team Collaboration** - Configures collaboration features
+
+These are available from the UI to apply to a site only. The existing PowerShell modules are lacking the functionality to replicate the behaviour. 
+
+---
+
+## The Solution: REST API Hack
+
+By using SharePoint's REST API hack through PnP PowerShell as a hack, we can programmatically apply these site designs to existing sites. Here's how to do it:
+
+# [PnP PowerShell](#tab/pnpps)
+
+```powershell
+# Configuration
+$siteDesignId = "b8ef3134-92a2-4c9d-bca6-2f14e79fe98e" # Project Management
+$webUrl = "https://yourtenant.sharepoint.com/sites/yoursite"
+
+try {
+    # Connect to SharePoint
+    Connect-PnPOnline -Url $webUrl
+    Write-Host "Connected to $webUrl" -ForegroundColor Green
+
+    # Get available site designs
+    $getSiteDesignsUrl = "$webUrl/_api/Microsoft.SharePoint.Utilities.WebTemplateExtensions.SiteScriptUtility.GetSiteDesigns"
+    $siteDesigns = (Invoke-PnPSPRestMethod -Url $getSiteDesignsUrl -Method POST -ContentType "application/json" -content "{`"store`": 1}").value | select Id, Title
+
+    Write-Host "`nAvailable Site Designs:" -ForegroundColor Yellow
+    $siteDesigns | ForEach-Object { Write-Host "  $($_.Id) - $($_.Title)" }
+
+    # Validate site design ID
+    $selectedDesign = $siteDesigns | Where-Object { $_.Id -eq $siteDesignId }
+    if (-not $selectedDesign) {
+        Write-Host "`nError: Site Design ID '$siteDesignId' not found!" -ForegroundColor Red
+         Write-Host "`nAvailable Site Designs:" -ForegroundColor Yellow
+         $siteDesigns | ForEach-Object { Write-Host "  $($_.Id) - $($_.Title)" }
+        exit 1
+    }
+
+    Write-Host "`nApplying site design: $($selectedDesign.Title)" -ForegroundColor Yellow
+
+    # Apply the site design
+    $restUrl = "$webUrl/_api/Microsoft.SharePoint.Utilities.WebTemplateExtensions.SiteScriptUtility.ApplySiteDesign"
+    $body = "{`"siteDesignId`": `"$siteDesignId`", `"webUrl`": `"$webUrl`", `"store`": 1}"
+    $response = Invoke-PnPSPRestMethod -Url $restUrl -Method Post -ContentType "application/json" -Content $body
+
+    Write-Host "✅ Site design '$($selectedDesign.Title)' applied successfully!" -ForegroundColor Green
+    
+    if ($response) {
+        Write-Host "Response details:" -ForegroundColor Cyan
+        $response | ConvertTo-Json -Depth 3
+    }
+}
+catch {
+    Write-Host "❌ Error applying site design: $($_.Exception.Message)" -ForegroundColor Red
+}
+```
+
+[!INCLUDE [More about PnP PowerShell](../../docfx/includes/MORE-PNPPS.md)]
+
+***
+
+## Source Credit
+
+Sample first appeared on [PowerShell Hack: Apply Out-of-the-Box SharePoint Site Designs to Existing Sites](https://reshmeeauckloo.com/posts/powershell-apply-outofthebox-sitedesigns/)
+
+## Contributors
+
+| Author(s) |
+|-----------|
+| [Reshmee Auckloo](https://github.com/reshmee011) |
+
+
+[!INCLUDE [DISCLAIMER](../../docfx/includes/DISCLAIMER.md)]
+<img src="https://m365-visitor-stats.azurewebsites.net/script-samples/scripts/spo-apply-OOB-sitedesign" aria-hidden="true" />

scripts/spo-apply-OOB-sitedesign/assets/preview.png

@@ -0,0 +1,56 @@
+[
+  {
+    "name": "spo-apply-OOB-sitedesign",
+    "source": "pnp",
+    "title": "Apply Out-of-the-Box SharePoint Site Designs to Existing Sites",
+    "shortDescription": "Apply Out-of-the-Box SharePoint Site Designs to Existing Sites",
+    "url": "https://pnp.github.io/script-samples/spo-apply-OOB-sitedesign/README.html",
+    "longDescription": [
+      "Apply Out-of-the-Box SharePoint Site Designs to Existing Sites"
+    ],
+    "creationDateTime": "2025-08-01",
+    "updateDateTime": "2025-08-01",
+    "products": [
+      "SharePoint",
+      "Sites"
+    ],
+    "metadata": [
+      {
+        "key": "PNP-POWERSHELL",
+        "value": "3.1.91"
+      }
+    ],
+    "categories": [
+      "SharePoint"
+    ],
+    "tags": [
+      "modern",
+      "Connect-PnPOnline",
+      "Invoke-PnPSPRestMethod"
+
+    ],
+    "thumbnails": [
+      {
+        "type": "image",
+        "order": 100,
+        "url": "https://raw.githubusercontent.com/pnp/script-samples/main/scripts/spo-apply-OOB-sitedesign/assets/preview.png",
+        "alt": ""
+      }
+    ],
+    "authors": [
+      {
+        "gitHubAccount": "reshmee011",
+        "company": "",
+        "pictureUrl": "https://avatars.githubusercontent.com/u/7693852?v=4",
+        "name": "Reshmee Auckloo"
+      }
+    ],
+    "references": [
+      {
+        "name": "Want to learn more about PnP PowerShell and the cmdlets",
+        "description": "Check out the PnP PowerShell site to get started and for the reference to the cmdlets.",
+        "url": "https://aka.ms/pnp/powershell"
+      }
+    ]
+  }
+]