Smart Solutions
Need help?
  • 100% Free & MIT Licensed
  • No third-party data hosting

How to install SharePoint Smart Storage Analyzer

SPFx web part · about 10 minutes · Last updated · By Sean Regan

Stuck on approvals or tenant policies?

Let our team handle setup with you

Our Quick Start setup covers App Catalog deployment, permission approvals, and a guided first run, and we can help you prepare what your change board needs.

Smart Storage Analyzer at a glance

Product
SharePoint Smart Storage Analyzer
Type
SPFx web part (.sppkg)
Where it runs
Inside SharePoint Online pages, as the signed-in user
Admin needed
SharePoint Administrator, once, to deploy the package
Setup time
About 10 minutes
License
Free, MIT open source

Before you start

  • A Microsoft 365 tenant with SharePoint Online.
  • A tenant App Catalog site. If you do not have one, a SharePoint Administrator can create it in the SharePoint admin center under More features > Apps.
  • SharePoint Administrator or Global Administrator rights to upload and deploy the package once. End users need no elevated rights.
  • Site Owner (Full Control) rights on the site where you add the web part.

Install, step by step

  1. 1.Download the package

    Download the latest .sppkg file from the SharePoint Smart Storage Analyzer GitHub Releases page. It is a single file — there is no installer and nothing runs on a server.

  2. 2.Open your tenant App Catalog

    In the SharePoint admin center, go to More features > Apps > App Catalog, then open Apps for SharePoint.

  3. 3.Upload the package

    Drag the .sppkg file into the Apps for SharePoint library. SharePoint reads the manifest and shows a trust dialog.

  4. 4.Deploy and trust

    Choose whether to make the solution available to all sites in the organization, then select Deploy. Deploying tenant-wide saves adding the app to each site individually.

  5. 5.Add the app to a site

    On the SharePoint site where you want the tool, open Settings > Add an app (or Site contents > New > App) and pick the solution. Skip this step if you deployed tenant-wide with the app auto-installed.

  6. 6.Add the web part to a page

    Edit a modern site page, click the + to add a web part, search for the tool by name, and place it on the page. Publish the page.

Your first real result, in about 10 minutes

Installing is not the win — the win is one result you can show someone. Goal: Find the biggest storage offender in a site and quantify the saving.

  1. 1.Open Tree View from Home

    Start with a site you know is big. The root treemap sizes every document library on the site by storage.

  2. 2.Drill into the biggest rectangle

    Click through until you reach the folder actually responsible. This usually takes three clicks.

  3. 3.Switch to list view for the numbers

    Sortable folder totals and item counts give you figures you can quote.

  4. 4.Run a report with version history included

    Choose Storage Report from Home and include version history to see retained version bytes separately for each file.

  5. 5.Export the Storage Report

    Export to Excel and mark the archive candidates and the high-version libraries.

  6. 6.Save the scan

    Scan history keeps the run, so after clean-up you can re-scan and show the before/after difference.

First run: what to do next

  • Run the Explorer treemap first to see where the weight sits before configuring a full report.
  • Tree View and List View always include per-file version-history size at no extra cost. In Storage Report, leave Include Version History Size on for a true storage total, or turn it off for a faster current-content-only scan.
  • Use the stale-file report to build an archive candidate list before touching anything.

Troubleshooting

Folder totals look lower than expected
Version-history size is per file and additive. Folder rows never include version bytes because SharePoint exposes no recursive rollup. In a completed Storage Report, the Version History Size tile totals the measured per-file values separately.
The scan is slow
Most libraries return version-history data in the same bulk read. Some lists require per-file fallback measurements; Storage Report identifies that stage while it runs. Disable Include Version History Size for a faster current-content-only report, or lower concurrent requests if SharePoint is throttling.
Some libraries are missing
The scan runs as the signed-in user and requires Site Owner access or the Manage Web / Manage Permissions right. Include hidden/system libraries in Settings when needed; inaccessible subsites or folders are listed in the partial-results warning.

FAQ

Can it measure version history size?
Yes. Tree View and List View always show it per file. Storage Report has a separate Include Version History Size option, enabled by default. It is additive to current-file size.
Does it delete anything?
No. It reports; the cleanup decisions stay with you.
Can I export the report?
Yes, to Excel or CSV for review.
Which languages does the interface support?
Smart Storage Analyzer supports 30 interface languages. It follows each signed-in user's Microsoft 365 display language, or the site's default, and falls back to English when needed. File, folder, and library names are not translated.

Stuck on approvals or tenant policies?

Let our team handle setup with you

Our Quick Start setup covers App Catalog deployment, permission approvals, and a guided first run, and we can help you prepare what your change board needs.

Install another tool