Versioning in SharePoint Online is a powerful feature that allows teams to maintain historical copies of documents. However, over time, these versions can accumulate and consume significant storage space—especially in document libraries with frequent updates.
This article provides a step-by-step PowerShell script using the SharePointPnPPowerShellOnline module to clean up old versions of files in a specific folder within a document library—retaining only the latest 5 versions of each file.
🔧 Why This Is Useful
-
Storage Optimization: SharePoint libraries with thousands of old file versions can significantly inflate site storage.
-
Performance: Reducing version history helps improve performance in large libraries.
-
Targeted Cleanup: Instead of affecting the entire document library, you can limit cleanup to a specific folder.
🛠️ Prerequisites
-
Install the PnP PowerShell module:
SharePoint Online site URL and access permissions to the library/folder.
-
PowerShell with administrative rights.
📜 Script Overview
This script:
-
Connects to the SharePoint Online site.
-
Targets a specific folder in a document library.
-
Retrieves all files in that folder (recursively).
-
Keeps only the latest 5 versions of each file and deletes the rest.
🔍 PowerShell Script
📁 Example Folder Path
If your document library is called TestVersionsDocLib
and the target folder is Invoices/2025
, the relative URL should be:
/sites/yoursite/TestVersionsDocLib/Invoices/2025
✅ Output
The script will:
-
Display each file being scanned.
-
Show how many versions were found.
-
Confirm deletion of versions beyond the latest 5.
⚠️ Important Considerations
-
This script only affects a specific folder—not the whole document library.
-
Always test in a development or QA site before using in production.
-
Deleting versions is irreversible—ensure you retain what’s necessary.
$FolderSiteRelativeUrl = "Shared Documents/TargetTest"
Connect-PnPOnline -Url $SiteURL -UseWebLogin
# Test folder access
$Folder = Get-PnPFolder -Url $FolderSiteRelativeUrl
Write-Host "Folder found: $($Folder.Name)"
# Get files
$Files = Get-PnPFolderItem -FolderSiteRelativeUrl $FolderSiteRelativeUrl -ItemType File -Recursive
Write-Host "Found $($Files.Count) files in the folder"
You can test if the folder exists using this:
Get-PnPFolder -FolderSiteRelativeUrl "Shared Documents"
Get-PnPFolder -FolderSiteRelativeUrl "Shared Documents/4. Projects - WIP"
Get-PnPFolder -FolderSiteRelativeUrl "Shared Documents/4. Projects - WIP/FY'24"
Get-PnPFolder -FolderSiteRelativeUrl "Shared%20Documents%2F04%2E%20Projects%20%2D%20WIP"
Get-PnPFolder -FolderSiteRelativeUrl "Shared%20Documents%2F04%2E%20Projects%20%2D%20WIP%2FFY%2724%2FFY%2724%20%2D%20Cancellation%20Reason%20%26%20Subreason"
This helps isolate where the path is breaking.
📝 Final Thoughts
Keeping version history under control is a best practice for maintaining a clean and efficient SharePoint environment. Automating this process with PowerShell ensures consistency and saves valuable administrator time.
If you need to scale this to multiple folders or automate it on a schedule, consider integrating it into an Azure Automation Runbook or a task scheduler.