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

How to install SharePoint Smart Permissions

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 Permissions at a glance

Product
SharePoint Smart Permissions
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 Permissions 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: Produce an external-access report for one site and hand it to the site owner.

  1. 1.Add the web part to the site you are worried about

    Put it on a page in a site that actually has sharing activity — that is where the findings are.

  2. 2.Run a scan of the whole site

    Let it walk libraries, folders and items. The report separates every object into Inherited or Unique.

  3. 3.Filter to Unique

    Unique permissions are where oversharing lives. Everything inherited is already explained by the parent.

  4. 4.Filter to external and guest accounts

    External users on unique-permissioned items is the single highest-value finding in most tenants.

  5. 5.Expand group membership

    Expand M365 group and SharePoint group members so 'Marketing Members' becomes actual named people the owner recognizes.

  6. 6.Export to Excel and send it

    Export the filtered view and send it to the site owner with one question: 'should each of these people still have access?'

First run: what to do next

  • Run a report on a single library first so you can see the Inherited and Unique categories on a small dataset before scanning a whole site.
  • Site-wide scans with many uniquely permissioned items take longer — start the run and let it finish in the background.
  • Export to Excel when you want to hand the result to an owner for review.

Troubleshooting

The web part does not appear in the picker
The solution is deployed but not added to that site. Use Site contents > New > App to add it, or redeploy tenant-wide with the option to make it available to all sites.
Some items are missing from the report
The report runs as the signed-in user. Items you cannot read are not returned. Run as a Site Collection Administrator for a complete picture.
A Microsoft Graph permission consent prompt appears
Certain lookups need Graph scopes granted once in the SharePoint admin center under Advanced > API access. A SharePoint or Global Administrator approves the pending request.

FAQ

Can Smart Permissions change permissions?
No. It is strictly read-only. It reports which objects inherit and which have unique permissions, and who has access — it never grants, removes, or resets anything.
Do end users need extra rights?
No. Anyone with access to the page can run a report scoped to what their own account can already read.
Does data leave the tenant?
No. The web part runs in the browser inside your SharePoint site and calls only Microsoft APIs.
Which languages does the interface support?
Smart Permissions 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. SharePoint names and content 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