ShareMaster is shaped by your feedback. Tell us what to build next →
Features All features overview
Migration Tools Overview Structure and content OneDrive ↔ SharePoint Content only Structure only Move / Copy Upload from this computer Download to this computer Dropbox to SharePoint Resume and incremental runs
Microsoft Teams Overview Copy a team Move channels Merge teams Inactive teams Ownerless teams Guests and external access Export a team Search everyone's chats
Recycling Bin Overview Browse a site's recycle bin Empty recycle bins in bulk Restore and purge history Deleted teams
Archive Overview Configure the tenant On Demand Archive Restore Archived Files Archive Savings Report Blob Viewer
Optimise Storage Tools Overview Delete all items in a list Delete all files and folders in a library Remove empty folders Remove duplicate files Reduce image sizes Delete sites and subsites
SharePoint Tools Overview Tenant Explorer SharePoint Explorer Easy Settings Fix renamed groups List Explorer Search the Preservation Hold Library
Search & Indexing Overview Search query Item search properties Reindex Crawl log
Replace Overview Replace in SharePoint Replace in local files Find password-protected files Remove PDF passwords
Shared Links Overview Report shared links Report unique permissions Remove a person from sharing links Remove shared links Remove unique permissions
Version History Overview Version trimming Version trimming report Reset file version
Reports Overview Inventory report Folder inventory Site and subsite storage Storage growth Security matrix Teams permissions Pre-migration analysis Compare items Dropbox to Microsoft 365 compare Duplicate file report Empty folder report Image size report Recycle bin report Unused licences Copilot readiness Inactive sites, OneDrives and groups Orphaned users Site settings Audit activity Groups Checked-out files report Report history
Developer Tools Overview Query Builder PnPjs Console Property Bags SPFx Customizers Webhooks Customisation audit
Pricing Services Demos Blog Guides Use cases Compare Tools Alerts FAQ Contact
  1. Home
  2. Guides
  3. Trim Version History

How to Trim SharePoint Version History

SharePoint's default versioning settings create a new version every time a file is saved and keep up to 500 of them per file. On an active document library, that means a 10 MB file can quietly consume 500 MB or more in version history over a few years. This guide walks through how to find, measure, and trim that history without deleting any live content.

Why version history grows so fast

SharePoint Online enables versioning by default on document libraries. Each time a user saves a file, opens it in the browser editor, or syncs a change through OneDrive, SharePoint stores the previous copy as a version. Under the default 500-version cap, a file edited a few times a week can still have every edit from the last few years sitting in version storage.

The problem is that the storage figures in the SharePoint admin center show total usage per site without breaking out how much is version history. Microsoft does offer a version storage usage report, but it is queued per site or library through PowerShell. Without a breakdown, it is easy to underestimate how much version history has accumulated and hard to target it selectively.

Step 1: Audit current version storage

Before trimming anything, get a clear picture of where the version storage is concentrated. Two read-only ShareMaster reports, both free on every plan, give you that picture:

  • Folder inventory: one row per folder on the sites, libraries or folders you pick, with its total size, version history included, and its file count, so the heavy libraries stand out.
  • Version trimming report: run it on those libraries with the keep rule you are considering, and it downloads an Excel of exactly what would be trimmed from each file and how much storage that would reclaim. Nothing is removed.

With this data, you can target the libraries that will give you the most storage back from a single trim operation rather than running blanket trims across every site.

Focus on the outliers. Version storage is rarely spread evenly; a handful of heavily edited libraries usually account for most of it. Find those libraries with the Folder inventory before you start the trim.

Step 2: Decide on a version keep policy

A version keep policy defines how many versions to retain per file. Versions older than the keep count will be deleted. Choosing a keep count involves balancing storage savings against the practical and compliance needs of the business.

Common keep counts by organisation type

  • General business libraries (HR, internal comms, general documents): 10 to 15 major versions is a comfortable default. Most users never look back more than a few revisions.
  • Finance and legal (non-regulated): 20 to 30 major versions provides a longer audit trail without keeping everything.
  • Regulated industries (healthcare, legal document control, financial services): check with your compliance team first. Some document control frameworks require specific version retention as part of the record.
Get sign-off before trimming. Always confirm in writing with the business owner that older versions are not needed for compliance, audit, or regulatory reasons before running a version trim. Some industries treat version history as part of the document control record.
Illustration: a stack of layered document versions with one sheet lifted clear.
How to Trim SharePoint Version History

Step 3: Run ShareMaster's Version trimming

Once you have your target libraries and keep count, open Version trimming in ShareMaster. The SharePoint version trimming tool page sets out every rule it offers and how it compares with SharePoint's own options.

  1. Sign in to the target tenant.
  2. Select what to process: sites, libraries or folders you pick, a CSV list, or the whole tenant.
  3. Enter your keep count. Version trimming keeps the current version plus the newest n earlier versions and removes the rest. Optional rules keep at most a number of versions a day, keep versions a minimum number of hours apart, only remove versions before a date, skip recently modified files, or narrow the run by file name or extension. A version is removed only when every rule you switched on agrees.
  4. Check what goes. A run across several libraries shows a preview of what each file would lose and asks before removing anything. A single library is trimmed as it is scanned once you confirm, so if you want the list first, run the Version trimming report with the same rules.
  5. Run it. By default the removed versions go to the recycle bin, so they stay recoverable for the retention window; a permanent delete that frees the space at once is an option, behind its own warning. Large libraries may take from several minutes to several hours depending on file count.

Version trimming does not touch the current (latest) version of any file. If a file has 120 versions and your keep count is 10, it keeps the current version and the 10 before it, and removes the 109 older ones.

Run trims outside business hours. Version deletion calls the SharePoint API and counts against your tenant's throttle limits. For large trim operations spanning many thousands of files, starting the run in the evening reduces the risk of hitting Microsoft's limits during the business day.

Step 4: Verify the results

After the trim completes, run the Folder inventory again on the same sites. Compare the storage figures before and after to confirm the expected reduction. Spot-check a few files in the trimmed libraries to verify that:

  • The current version of each file is intact and opens correctly.
  • Version history in SharePoint shows the expected number of remaining versions.
  • No files were skipped or partially processed.

Every run is kept in ShareMaster's Report history with an Excel report of what it did, so you can open it again later without re-running anything. If you sent the versions to the recycle bin, they keep counting against storage until the bin is emptied or the retention window passes.

Step 5: Set a version limit going forward

A trim fixes the historical accumulation, but without a lower version limit in place, the library will rebuild the same problem over the next few years. SharePoint lets you set a version limit at the library level, and from PowerShell for a whole site.

Two ways to apply limits:

  1. Through SharePoint: open the library, go to Library settings, then Versioning settings. Set a maximum number of major versions (the page accepts 100 or more), or Set-SPOSite -MajorVersionLimit with -ApplyToExistingDocumentLibraries for every library in a site.
  2. Through ShareMaster's Easy Settings: search for the version limit and set it on a library, or set the limit a site gives libraries created from now on, without clicking through the settings pages. Lowering a library's limit permanently deletes the versions above it, so trim first if you want them in the recycle bin instead.

How much storage can you expect to reclaim?

It depends on how many versions your files hold, which is why the report run matters: the Version trimming report lists the space each file would give back before anything is deleted. For a sense of scale, Microsoft's own examples for its automatic version limits show version storage falling by around 94 to 96 percent against a plain 500-version count limit.

How much of that turns into tenant headroom depends on how much of your quota is version history rather than current files, and on how fast content keeps growing.

For context on how tenant storage quotas work, see the SharePoint Online storage limits reference.

Related guides

Last updated