Repository navigation
Releases
v1.7.2
Installation
- Download
smart-permissions.sppkg - Upload to your SharePoint App Catalog
- Deploy tenant-wide or to specific sites
- Grant the required Microsoft Graph API permissions in the SharePoint Admin Center
Changed
- Permissions Explorer — library permissions on load
The permissions panel now shows the selected library's own permissions as
soon as it loads, instead of an empty "Select a folder or file" message. - Permissions Explorer — "Show parent permissions" is on by default
Inherited items show where their permissions come from without an extra
click. The checkbox is still there to turn it off.
Fixed
- Folders starting with an underscore were hidden
The Permissions Explorer, Permissions Report, and User Access tools skipped
every folder whose name began with_, so real folders such as
_Sales Managernever appeared and any unique permissions on them were
missed. Only SharePoint's own system folders are skipped now:Forms,
_cts,_w,_t,_private,_catalogs,_layouts, and_vti_*
(matched case-insensitively). Formsfolder shown in the Permissions Explorer
The Explorer tree listedFormswhile the report and User Access scans
skipped it. All three tools now hide it consistently.
v1.7.1
Installation
- Download
smart-permissions.sppkg - Upload to your SharePoint App Catalog
- Deploy tenant-wide or to specific sites
- Grant the required Microsoft Graph API permissions in the SharePoint Admin Center
Added
- Permissions Report — risk summary
A row of one-click filter buttons above the results shows counts for
Everyone access, External users, Full Control (non-owners), and
Unconfirmed items, and filters the table to just those entries. - Permissions Report — open and copy links
Each result row has an "Open in SharePoint" link and a "Copy path" button. - Permissions Report — view saved reports
A "View" button on each History row opens a saved report in the web part,
with a banner marking it as a saved report. History is now kept separately
for each site, and a "Clear history" button removes everything after a
confirmation. - User Access — "Access via" column
Shows the group or assignment that grants the access at each location,
sortable on screen and included in the Excel export. - Permissions Explorer — nested Entra groups
A group inside an Entra group is now shown as a Security Group row with
its members indented beneath it, down to five levels, instead of appearing
as a user. Groups that contain each other are expanded only once. The same
expansion applies in the Permissions Report. - Permissions Explorer — remembers the library
Opens on Shared Documents the first time, then on the last library picked
for that site. - Property pane options
Toggles to hide the Permissions Report, Permissions Explorer, or User
Access card, plus a default site URL and a lock that removes the Change URL
link for viewers. - Home screen shows the connected site
The brand banner with the site URL, Change URL, and Settings now appears on
the home screen as well as the tool screens.
Changed
- Confirmations before losing work
Leaving a screen during a scan, deleting a saved report, and clearing
history now ask first, using a dialog instead of a browser prompt. - User Access — accuracy
Access through Entra and Microsoft 365 groups, including groups inside
SharePoint groups, is now resolved from the user's group memberships, and
locations that could not be fully checked are flagged as possibly incomplete. - Clearer states
Added a "no results match the current filters" message, a notice when scan
options change after results were produced, a retry button when a library
fails to load, and a hint when the user list is truncated. - Export safety
CSV cells that begin with=,+,-, or@are prefixed so spreadsheet
apps open them as text rather than running them as formulas. - Input handling
Site URLs pasted with a trailing slash or a page path are cleaned up, and
invalid numeric settings fall back to their defaults instead of stalling a
scan. - Provisioning scripts
scripts/Provision-SmartPermissions.ps1no longer needs PnP.PowerShell or
an app registration: it signs in with a device code, remembers the sign-in,
and uses SharePoint REST. The PnP version is now
scripts/Provision-SmartPermissions-PnP.ps1. Both remove duplicate
Permissions navigation links on re-run and no longer set page audience
targeting (the page is limited to Site Owners by permissions alone).
Documentation
- Updated the User Guide and README for all of the above.
- Refreshed the home screen screenshot.
v1.7.0
Installation
- Download
smart-permissions.sppkg - Upload to your SharePoint App Catalog
- Deploy tenant-wide or to specific sites
- Grant the required Microsoft Graph API permissions in the SharePoint Admin Center
Added
- Multilingual interface — 30 languages
The web part's entire user interface is now localized: Arabic, Chinese
(Simplified & Traditional), Czech, Danish, Dutch, English, Finnish, French,
German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese,
Korean, Norwegian Bokmål, Polish, Portuguese (Brazil & Portugal), Romanian,
Russian, Spanish, Swedish, Thai, Turkish, Ukrainian, and Vietnamese. The
displayed language follows the SharePoint page's own UI culture
automatically — there is no separate language picker to configure.
v1.6.1
Added
- Exclude Sharing Links filter
New "Exclude Sharing Links" option hides the internalSharingLinks.<guid>.*
groups SharePoint auto-creates for "Anyone with the link" and "Specific
people" sharing links, alongside the existing "Exclude Limited Access"
filter. Applies everywhere the existing filter did — Permissions Report,
Permissions Explorer, and User Access, on-screen and in exports. - Exclude Limited Access / Exclude Sharing Links now available directly from
the Permissions Report screen, in the same filter bar as "Unique
permissions only" and "External users only," not just on the Settings page. - Permissions Report — site/tenant-named exports
Excel and CSV exports from the Permissions Report are now prefixed with
the scanned site's name, orTenantfor an all-site-collections scan
(e.g.SP_Permissions_Tenant_20260729...xlsx), instead of a generic
SP_Permissions_<timestamp>name — exports from different scans no
longer look identical once several have piled up in a downloads folder.
Changed
- Wider Permissions Report and User Access screens
Both screens' maximum width was increased to 1100px (previously 760px and
900px respectively) to match the Permissions Explorer and Home screens,
giving the results tables more room. - Permissions Report — precise throttling warning
The "SharePoint throttled this scan" banner previously said only that
results "may be incomplete," with no way to tell whether the scan was
actually usable. It now states the exact number of items (if any) that
couldn't be confirmed after retrying, points to the existing
"could not be fully read" notice for exactly which ones, and confirms
everything else in the report was read successfully — or, if every
retried item ultimately succeeded, says so plainly instead of leaving
the scan under a cloud of doubt. - Permissions Report — precise restricted-access warning
Previously, a single item denied during a scan (e.g. one site collection
in a tenant-wide scan where the account was still Member-level rather
than Site Owner) triggered a blanket "results may be incomplete" banner
that read as if the entire report couldn't be trusted, even when
everything else scanned successfully. The warning now reports exactly
how many items (out of the total scanned) were denied and lists up to
10 of the specific site, library, folder, or file paths affected (with
an "…and N more" summary beyond that), so a mostly-successful scan no
longer reads as a failed one.- Folder- and file-level permission denials, which previously weren't
tracked at all, are now recorded and surfaced the same way as site-
and library-level denials.
- Folder- and file-level permission denials, which previously weren't
Documentation
- Documented the Permissions Report's per-library selection picker (select
or exclude specific libraries before a Folders/Files & Folders scan) in
the User Guide, which had never described it despite it existing in the
UI. - Added a "Partial Results Due to Restricted Access" section to the User
Guide covering the new restricted-access warning behavior above. - Documented the new "Exclude Sharing Links Entries" setting and clarified
that both it and "Exclude Limited Access Entries" can now be toggled from
the Permissions Report screen's filter bar, not just from Settings.
v1.6.0
Fixed
- Localized (non-English) tenant accuracy
- System role filtering ("Limited Access" / "Web-Only Limited Access") now
checks SharePoint's language-invariantRoleTypeKindfield first, falling
back to the English display name only whenRoleTypeKindisn't
available. Previously the check matched only the English name, so these
auto-assigned, no-meaningful-permission roles weren't recognized on
non-English tenants and appeared as noise in every tool's results. - "Full Site Access" / Owner-level detection in User Access, and
permission-level color-coding for badges and Excel exports across all
three tools, now use the sameRoleTypeKind-first classification instead
of matching English words like "Full Control" or "Edit" in the role name. - The provisioning script (
scripts/Provision-SmartPermissions.ps1) now
resolves the pages library by its stable "SitePages" URL segment instead
of the localized "Site Pages" display title, so page permissions, Quick
Launch navigation, and audience targeting no longer silently fail to
apply on non-English sites.
- System role filtering ("Limited Access" / "Web-Only Limited Access") now
- Provisioning script — Quick Launch de-duplication
The existing-node check before adding the page to Quick Launch now matches
on URL as well as title, so an unrelated page that happens to share the
same title is left alone instead of having its nav node replaced.
Changed
- Added a
workbenchnpm script (gulp clean && gulp serve) as a
convenience alias for starting the local dev server.
v1.5.1
Changed
- Home screen — card layout
Feature card screenshots now sit between the title/description and the
action button instead of above the title, withobject-position: left top
cropping and added footer padding around the button. - Documentation — refreshed screenshots
All home screen and feature screenshots regenerated to reflect the current
UI.
v1.5.0
What's New in v1.5.0
Fixed
- Provisioning script — App install now targets the tenant App Catalog and waits for install completion; publishing uses the current
Set-PnPPage -Publishcmdlet; the web part is resolved viaGet-PnPAvailablePageComponentsinstead of a raw ID string; fixed a duplicate-webpart guard and non-English "Site Pages" library resolution; added optional$clientIdsupport; Quick Launch de-duplication now also matches by URL. - Audit accuracy — Items that fail a unique-permission check after retries are now flagged as scan-incomplete instead of silently shown as inheriting; retry/backoff now covers thrown/rejected requests, not just 429/503; a Graph permission error in the M365-group ownership check now surfaces as "Graph permission required" instead of a false "Member" result;
transitiveMemberOfnow follows@odata.nextLinkpast 999 groups; group member expansion resolves by numeric group ID;checkCanManagePermissionsnow fails closed on API errors; "Everyone" / "Everyone except external users" claims are now flagged as tenant-wide access; the "exclude limited access" and "external users only" filters are now applied consistently across Explorer, Report, and User Access (including exports). - Explorer reliability — Folder prefetches are now bounded by scan concurrency; background scans/prefetches are discarded on library switch instead of applying stale results; failed folder listings show inline error text instead of a broken tree node.
Changed
- Permissions Report export buttons moved to the top of the results, above the summary badges.
- User-identifying diagnostic logging in User Access is now gated behind
localStorage.setItem('smartPermissionsDebug', '1'). - Documentation (README, USER-GUIDE) updated to match current behavior.
Installation
Upload smart-permissions.sppkg to your SharePoint Tenant App Catalog.
Optionally approve the GroupMember.Read.All Graph permission in SharePoint Admin Center → Advanced → API access to enable Security/M365 group member expansion.
See the User Guide for full documentation.
v1.2.0
What's New in v1.2.0
Added
-
User Access — site permission shown for M365 Group members
Users who access a site through a Microsoft 365 Group now correctly see a site-level permission entry. Uses a three-tier detection approach: SP group REST membership check, M365 Group detection via the site'sGroupIdand associated groups, and GraphtransitiveMemberOffallback. -
User Access — highest permission shown when in multiple groups
When a user is in both Owners and Members, Full Control is shown instead of Edit. Owner status is checked viaGET /groups/{id}/owners/{userId}. -
Permissions Explorer — permission-denied banner for member accounts
A blue informational banner now appears when role-assignment reads fail with HTTP 403, explaining that external user indicators and permission tables may be incomplete for the current account. -
User Access — "New scan" replaces "Scan again"
The button now clears results and returns to the user picker instead of re-running the same user.
Fixed
- "Web-Only Limited Access" and other system-assigned pass-through roles no longer appear as site permissions
- Site permission detection now works for M365-backed SharePoint groups using
sitegroups/getbyidinstead ofgetbyloginname - Scan in-progress text simplified to "Scanning…"
Installation
Upload smart-permissions.sppkg to your SharePoint Tenant App Catalog.
Optionally approve the GroupMember.Read.All Graph permission in SharePoint Admin Center → Advanced → API access to enable M365 Group membership detection in User Access.
See the User Guide for full documentation.
Latest Build (v1.6.1.0)
Automated build from commit f4367de.
Upload smart-permissions.sppkg to your SharePoint App Catalog to deploy.
v1.0.0 — Initial Public Release
Initial public release of SharePoint Smart Permissions.
Features
-
Permissions Report — Scans a site's libraries, folders, and files and exports a colour-coded Excel workbook of every unique permission assignment. Supports group member expansion (SharePoint groups, Security groups, M365 groups) and full-tenant scans from the root site.
-
Permissions Explorer — Interactively browse a document library tree and inspect live permissions on any folder or file. Shows inherited vs. unique permissions with a clear visual indicator, and supports real-time group member expansion.
-
User Access — Look up any user and see every location they can access, with their exact permission level at each location. Detects full-site owner access immediately.
Highlights
- Runs entirely in the browser as an SPFx web part — no PowerShell, no elevated service accounts
- Uses the signed-in user's own credentials; read-only, no data stored or transmitted externally
- SharePoint site theme colours applied automatically
- Configurable default view via the web part property pane
See README.md for setup and deployment instructions.