SharePoint Online: How to Deploy a Design Package Solution (WSP) using PowerShell?

Requirement: Deploy a design package solution (WSP) in SharePoint Online.

Prerequisites: You must activate publishing infrastructure feature both at site collection and site levels before deploying any design package!

How to deploy a Solution Package using PowerShell?

You may have a solution package WSP file for site template or design package for branding, or some other sandbox solution. Here is how the SharePoint Online Solution Deployment works:

Use the following steps to deploy a WSP solution in SharePoint Online.

  1. Log in as a Site Collection Administrator >> Navigate to your SharePoint Online Site Collection (Root Site) >> Click on “Site settings”.
  2. On the site setting page, click on the “Solutions” link under the “Web Designer Galleries” section. This opens the solution page as below screen. On the solutions page, Click on the “upload solution” button from the ribbon. upload solution package in sharepoint online
  3. Browse and select the WSP file from your local disk and Upload the solution.sharepoint online design package deployment
  4. After clicking on the “OK” button, SharePoint Uploads the WSP file and presents you a page from which you can activate the solution, as shown below. It takes a while to activate the solution.activate design package in sharepoint online
  5. Finally, the solution will be activated in your SharePoint Online site! How to Deploy a Design Package Solution (WSP) in sharepoint online using PowerShell

PowerShell to deploy a Solution Package in SharePoint Online:

This PowerShell script deploys the given solution package and activates the solution.

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

Function Deploy-SPOSolution()
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [string] $WSPFilePath,
        [Parameter(Mandatory=$False)] [Int] $MajorVersion = 1,
        [Parameter(Mandatory=$False)] [Int] $MinorVersion = 0

    Try {
        #Setup the context
        $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
        $Ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.UserName,$Cred.Password)   

        #Get the Solution Gallery
        Write-Host -f Yellow "Uploading WSP File to Solution Gallery..."
        $SolutionGallery =  $Ctx.Web.Lists.GetByTitle("Solution Gallery")
        $SolutionGalleryRootFolder = $SolutionGallery.RootFolder

        #Get WSP File Name from Path
        $WSPFileName = $WSPFilePath.Substring($WSPFilePath.LastIndexOf("\")+1)

        #Upload the WSP to the solution gallery        
        $WSPFileStream = New-Object System.IO.FileStream($WSPFilePath, [System.IO.FileMode]::Open)
        $FileCI = New-Object Microsoft.SharePoint.Client.FileCreationInformation
        $FileCI.Overwrite = $True
        $FileCI.ContentStream = $WSPFileStream
        $FileCI.URL = $WSPFileName
        $UploadedFile = $SolutionGallery.RootFolder.Files.Add($FileCI)
        Write-Host -f Green "`tUploaded WSP File to Solution Gallery!"   

        #Install the solution
        Write-Host -f Yellow "Installing Solution..."
        $WSP = New-Object Microsoft.SharePoint.Client.Publishing.DesignPackageInfo
        $WSP.PackageGuid = [System.Guid]::Empty
        $WSP.PackageName = $WSPFileName
        $WSP.MajorVersion = $MajorVersion
        $WSP.MinorVersion = $MinorVersion

        #Install the solution from the file url - This creates a solution according to the Major and Minor Version
        $WSPFileURL = $SolutionGallery.RootFolder.ServerRelativeUrl + "/" + $WspFileName;
        [Microsoft.SharePoint.Client.Publishing.DesignPackage]::Install($Ctx, $Ctx.Site, $WSP, $WSPFileURL)
        Write-Host -f Green "`tInstalled the Solution Successfully!"   

        #Activate the solution
        Write-Host -f Yellow "Activating the Solution..."
        [Microsoft.SharePoint.Client.Publishing.DesignPackage]::Apply($Ctx, $Ctx.Site, $WSP)
        Write-Host -f Green "`tActivated the Solution Successfully!"

        #Remove the original wsp file uploaded
        $UploadedSolutionFile = $SolutionGallery.rootFolder.Files.GetByUrl($WSPFileURL)

        Write-Host -f Green "`n*** WSP Deployment has been successfully completed!***"
    catch {
        write-host "Error: $($_.Exception.Message)" -foregroundcolor Red

#Set Parameters
$SiteURL = ""
$WSPFilePath  = "C:\Users\salaudeen\Desktop\Crescent-Projects-v2.wsp"

#Get Credentials to connect
$Cred = Get-Credential

#call the function to deploy the solution
Deploy-SPOSolution -SiteURL $SiteURL -WSPFilePath $WspFilePath

Salaudeen Rajack

Salaudeen Rajack - Information Technology Expert with Two decades of hands-on experience, specializing in SharePoint, PowerShell, Microsoft 365, and related products. Passionate about sharing the deep technical knowledge and experience to help others, through the real-world articles!

One thought on “SharePoint Online: How to Deploy a Design Package Solution (WSP) using PowerShell?

  • Hi Salaudeen,

    Great script.

    For me this fails on step 3: Activating the Solution.

    1) To Fix this i had to download the below Dll and add a path to this in the beginning of the script.

    2) I had to enable “SharePoint Server Publishing Infrastructure” in Site Collection Features.

    Otherwise the script works great.




Leave a Reply

Your email address will not be published. Required fields are marked *