SharePoint Online: How to Change the Header Banner Image in Modern Site Pages?

Requirement: Change the Header Banner Image on Modern Site Pages.

How to Change the Header Background image in SharePoint Online Site Page?

The header banner image serves as the backdrop and creates a visual impact on Modern Pages in SharePoint Online. In this guide, let’s see the steps to change the banner image on your Modern Site Pages in SharePoint Online. Here is how to change the default header image on the ‘Site Page’ on SharePoint Online:

1. Navigate to the modern site page. E.g., https://crescent.sharepoint.com/sites/marketing/SitePages/About-Us.aspx
2. Click on the “Edit” button on the top right area. 

   

3. Click on the top header area to select it, and then click on the little image icon, as shown below.

   

4. You can upload a new image, use a URL, or select an existing image for a banner from the site. Once selected, drag and set a focal point.
5. Save and publish the page.

   

SharePoint Banner Size: Here are the SharePoint Online modern page banner image size recommendations from Microsoft: Banner Image Size Reference for SharePoint Online

PnP PowerShell to Change Banner Image

Alternatively, you can also change the header background image by PowerShell. Here is the PnP PowerShell script to change the banner image on the site page:

#Parameter
$SiteURL= "https://crescent.sharepoint.com/sites/marketing/"
$PageName = "About-us.aspx"
$PageHeaderImage = "/sites/marketing/images/banner.png"  #Server Relative URL

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)

#Get Client Side Page
$Page = Get-PnPClientSidePage -Identity $PageName

#Set page header image
$Page.SetCustomPageHeader($PageHeaderImage)

#Save and publish the page
$Page.Save()
$Page.Publish() 

This script Connects to SharePoint Online using the Connect-PnPOnline cmdlet, gets the page, and sets the header image.

Add Banner Image to All Pages in Site Pages Library

What if you want to change the banner image for all pages in the “Site Pages” library?

#Parameter
$SiteURL= "https://crescent.sharepoint.com/sites/marketing"
$LibraryName = "Site Pages"
$PageHeaderImage = "/sites/marketing/SiteCollectionImages/banner.png"

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)

#Get all Pages from the Library
$Pages = Get-PnPListItem -List $LibraryName

#Loop through each Page 
ForEach($Page in $Pages)
{
    #Get the Modern Site Page - Errors on Classic Pages
    $ClientSidePage = Get-PnPClientSidePage -Identity $Page.FieldValues.FileLeafRef -ErrorAction SilentlyContinue

    If($ClientSidePage)
    {
        Set-PnPPage -Identity $ClientSidePage -HeaderType Custom -ServerRelativeImageUrl $PageHeaderImage -Publish  #-TranslateX 5.2 -TranslateY 10.5
        Write-host -f Green "Changed Banner in Page:"$Page.FieldValues.FileRef
    }
}

In summary, You can change the header background image in SharePoint Online Modern Pages by following a few simple steps through web browser UI or PowerShell, as explained above.