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.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.Open your tenant App Catalog
In the SharePoint admin center, go to More features > Apps > App Catalog, then open Apps for SharePoint.
3.Upload the package
Drag the .sppkg file into the Apps for SharePoint library. SharePoint reads the manifest and shows a trust dialog.
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.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.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.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.Run a scan of the whole site
Let it walk libraries, folders and items. The report separates every object into Inherited or Unique.
3.Filter to Unique
Unique permissions are where oversharing lives. Everything inherited is already explained by the parent.
4.Filter to external and guest accounts
External users on unique-permissioned items is the single highest-value finding in most tenants.
5.Expand group membership
Expand M365 group and SharePoint group members so 'Marketing Members' becomes actual named people the owner recognizes.
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.
