SharePoint Online: Apply Modern Theme using PowerShell

Requirement: Change the site theme in SharePoint Online.

How to apply theme in SharePoint Online?

In SharePoint Online, Themes are responsible for colors in various elements of the site. To align with your organization branding guidelines, you can create and apply a theme in SharePoint Online. There is a set of default site themes available for selection. You can also add your own custom theme to SharePoint Online. To set a theme in SharePoint Online modern sites,

  • Open your SharePoint Online site where you want to change the theme >> Click on the “Settings” gear icon.
  • In the “Settings” menu, click on “Change the Look”
  • Under themes, Select your desired theme (out of the box or custom theme) and click the “Save” button. The colors on themes can be further customized by clicking on the “Customize” button.
    sharepoint online change theme
  • This changes the theme for the site. Any user with a Design or Full Control permission level have the ability to change site themes.

Here is my other post on adding a modern theme using PowerShell in SharePoint Online: How to Add a Modern Theme using PowerShell in SharePoint Online?

PnP PowerShell to Change Theme in SharePoint Online

Here is how to change the theme in SharePoint Online using PowerShell. Make sure you have the theme added prior to running this script.

$AdminCenterURL = ""
$SiteURL = ""
$ThemeName = "Crescent Theme"
#Connect to Admin Center
Connect-PnPOnline -Url $AdminCenterURL -UseWebLogin
#Apply Theme to Web
Set-PnPWebTheme -Theme $ThemeName -WebUrl $SiteURL

PnP PowerShell to Apply Theme to All Subsites in a Site Collection

You can change the look and feel of a SharePoint Online site to match your corporate color scheme through themes.

#Function to set Theme for a web
Function Set-PnPSiteTheme($Web, [String]$ThemeName)
    Try {
        Write-host "Applying Theme on site: " $Web.URL
        #Set Theme for the site
        Set-PnPWebTheme -Theme $ThemeName -Web $Web -Connection $AdminConn
        #Get All Subsites
        $SubWebs = Get-PnPSubWebs -web $Web -Connection $SiteConn
        Foreach ($Web in $SubWebs)
            #Call the function recursively
            Set-PnPSiteTheme -Web $Web -ThemeName $ThemeName
    catch {
        write-host "Error: $($_.Exception.Message)" -foregroundcolor Red
$AdminCenterURL = ""
$SiteURL = ""
$ThemeName= "Corporate Theme"
#Connect to Admin Center
$AdminConn = Connect-PnPOnline -Url $AdminCenterURL -UseWebLogin -ReturnConnection

#Connect to SharePoint Online Site
$SiteConn = Connect-PnPOnline -Url $SiteURL -UseWebLogin -ReturnConnection

#Get the Root Web
$Web = Get-PnPWeb -Connection $SiteConn
#Call the function to set site theme for site collection
Set-PnPSiteTheme -Web $Web -ThemeName $ThemeName

How to Apply an OOTB Modern Theme in SharePoint Online using PowerShell

Alright, Instead of a custom theme, If you want to apply an out of the box default themes to your SharePoint Online sites, here is the script:

#Config Variables
$SiteURL = ""
#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -UseWebLogin
$Web = Get-PnPWeb 

#Apply OOTB Modern Theme
[OfficeDevPnP.Core.Utilities.Themes.ThemeManager]::ApplyTheme($Web, [OfficeDevPnP.Core.Enums.SharePointTheme]::Blue)

Here is the enumeration of available themes:

powershell to change sharepoint online site theme

To apply a composite that includes a color theme, font, and background URL in SharePoint Online, use: SharePoint Online: How to Change Site Theme using PowerShell?

Salaudeen Rajack

Salaudeen Rajack is a SharePoint Architect with Two decades of SharePoint Experience. He loves sharing his knowledge and experiences with the SharePoint community, through his real-world articles!

6 thoughts on “SharePoint Online: Apply Modern Theme using PowerShell

  • May 6, 2020 at 10:07 AM

    This article saved me a lot of time. God bless you, Salaudeen.

  • April 8, 2020 at 9:16 AM

    Set-PnPSiteTheme function does not work and throw a 401 error.
    Is there a workaround for that ?
    With Connect-PnPOnline as -admin the $web will be admin site…
    Help please

  • February 3, 2020 at 2:29 PM

    pnpPowershell to set theme doesn’t work.
    need to set Connect-PnPOnline url as -admin, not the site url you are applying theme to.

    • April 8, 2020 at 10:10 AM

      Yes, We need Tenant Admin Rights to run “Set-PnPWebTheme” cmdlet and must connect to Tenant Admin!


Leave a Reply