Update SharePoint Page Banner Image
This sample script shows how to update the banner image at the top of the SharePoint online modern page using PnP PowerShell
Summary
This sample script shows how to update the banner image at the top of the SharePoint online modern page using PnP PowerShell and CLI for Microsoft 365.
Scenario inspired from this blog post: Update SharePoint Page Banner Image using PnP PowerShell

# SharePoint online site url
$siteUrl = "https://contoso.sharepoint.com/sites/wlive"
# Name of the site page
$pageName = "Open-Door-Policy"
# Server relative URL of the image to use in site page header
$imageUrl = "/sites/wlive/SiteAssets/work-remotely.jpeg"
# Connect to SharePoint Online site
Connect-PnPOnline -Url $siteUrl -Interactive
# Update site page banner image
Set-PnPPage -Identity $pageName -HeaderType Custom -ServerRelativeImageUrl $imageUrl
# SharePoint online site URL
$siteUrl = "https://contoso.sharepoint.com/sites/wlive"
# Name of the site page
$pageName = "Open-Door-Policy.aspx"
# Server relative URL of the image to use in site page header
$imageUrl = "/sites/wlive/SiteAssets/work-remotely.jpeg"
# Get Credentials to connect
$m365Status = m365 status
if ($m365Status -match "Logged Out") {
m365 login
}
# Update site page banner image
m365 spo page header set --webUrl $siteUrl --pageName $pageName --type Custom --imageUrl $imageUrl
Contributors
| Author(s) |
|---|
| Ganesh Sanap |
Disclaimer
THESE SAMPLES ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.
Tool documentation & references
- Want to learn more about PnP PowerShell and the cmdlets
Check out the PnP PowerShell site to get started and for the reference to the cmdlets.
- Want to learn more about CLI for Microsoft 365 and the commands
Check out the CLI for Microsoft 365 site to get started and for the reference to the commands.