Back to Tech Tools

SharePoint Version & Storage Manager Under Development

Win back SharePoint storage by clearing out old file versions.

Every save in SharePoint keeps another full copy of the file, and those copies count against the tenant’s storage. This tool shows how many versions each site keeps and how much space each site uses, sets how many versions to keep, and permanently deletes the old versions over that number — for the whole tenant, one site, one library, one folder, or one single file.

Download the tool ZIP · 2.6 MB · v2.2.4 · extracts to a version-stamped folder · nothing to install

Running it

  1. Unzip anywhere.
  2. Double-click Start SPOToolkit.cmd. Your browser opens on the tool — leave the black window open while you use it; closing it signs you out. The first time on a PC without Node.js it fetches one file into its own folder (nothing is installed), exactly like the Permissions Scanner.
  3. Add the client: a name, and the tenant name if you know it (like contoso) — or leave that blank and it is found for you. If it is found for you, you type it once to confirm it really is that client’s tenant, before anything is read.
  4. Sign in with a code, exactly like the Permissions Scanner: go to microsoft.com/devicelogin, enter the code it shows, and pick the client’s Global Admin or SharePoint Admin account.
  5. Use the tabs: Overview, Set limits, Clear old versions, Jobs, Log. Every new client starts in a dry run.

This one permanently deletes. Old versions it removes skip the recycle bin and cannot be restored. The current version of every file is never touched — only older copies go.

So it starts every client in a dry run: it reads everything and shows exactly what it would delete, and changes nothing. Before a real delete it asks you to confirm the client approved it in writing, that you have checked Purview for retention and holds, and that you have checked for a Preservation Hold Library — then you type the tenant name, then DELETE.

Each delete is sent to SharePoint once. If SharePoint’s answer is unclear, the tool looks again to see what really happened — it never guesses and never sends it twice. Every deleted version is written to an audit file as it goes, and if that file can’t be written, nothing more is deleted.

For SharePoint’s own background jobs, the tool waits until SharePoint shows each new job and checks it is exactly what you asked for. If it isn’t, or SharePoint never shows it, the run stops and the screen says STOP IT NOW. Every job goes on the Jobs tab, where Stop works even in a dry run.

Choose what to clear

Paste the address from your browser’s address bar, or click through sites, libraries and folders. You always see a preview first — for a folder or file, every file and exactly which of its versions would go.

WhatWho does the deleting
The whole tenantSharePoint’s own background clean-up job, one per site. Takes hours or days; the tool watches it for you.
One siteSharePoint’s background job, for that site and all its subsites. If you paste a subsite, the tool says so and you have to choose the whole site on purpose — to clear just a subsite, pick one of its libraries.
One librarySharePoint’s background job, for that library only.
One folder and everything in itThis tool, straight away, file by file — and it lists exactly which versions went.
One fileThis tool, straight away.

Keep 5 means each file keeps its five newest versions, counting the file as it is now. A file with 298 versions keeps its 5 most recent; the other 293 are deleted. One exception: if a file is a draft right now, its newest published version — the one readers see — is always kept too. In a library with content approval, readers see the last approved version, so the tool won’t clear folders or files there — use One library.

Never touched

Signing in

The same as the Permissions Scanner: one code, Microsoft’s own sign-in, and nothing registered in the tenant — no app, no consent step. No password is ever typed into the tool, and nothing about the sign-in is saved: closing the window signs you out. Partners using GDAP: type the client’s tenant name in their profile, and the sign-in goes to the client’s tenant.

A SharePoint Admin or Global Admin can see every site and clear whole sites and the tenant. To clear a single library, folder or file, the account also has to be able to open that site — the tool says so, and how to fix it, if it cannot.

What you get

Not yet run against a live tenant. It has been tested end to end against a stand-in for Microsoft. Try it on a test tenant first: preview a site and check the line “Checked with this tenant’s SharePoint” says everything is offered, then do a dry run, then one live file.

DigiCave · Tech Tools