How to install SharePoint Smart Org Chart & Directory
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 Org Chart at a glance
- Product
- SharePoint Smart Org Chart & Directory
- 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.
- Graph consent for User.Read.All (directory read) approved once in the SharePoint admin center under Advanced > API access.
- Manager relationships populated in Entra ID — the chart is only as complete as the directory.
Install, step by step
1.Download the package
Download the latest .sppkg file from the SharePoint Smart Org Chart 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.Approve the Graph API request
In the SharePoint admin center, open Advanced > API access and approve the pending directory-read request. Without it the chart cannot read manager relationships or photos.
6.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.
7.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: Put a live, searchable org chart on the intranet home page.
1.Add the web part to a page people already visit
The intranet home page or the HR landing page. Nobody visits a page called 'Org Chart'.
2.Set the root person
Start at the CEO for the full tree, or at a department head for a team-scoped chart.
3.Choose the layout
Vertical or horizontal, with the number of levels shown by default. Deeper branches load on demand.
4.Turn on search and presence
Enable the searchable directory and Teams presence so the chart is also a people finder.
5.Apply your theme
Match the site theme and card fields (title, department, location) to what your organization actually uses.
6.Publish and share the link
No data export, no refresh schedule — it reads Entra ID live on every page load.
First run: what to do next
- Set the root person — usually the CEO or the head of a division — so the chart opens where people expect.
- Pick a layout (drill-down, horizontal tree, or vertical) and one of the themes to match your intranet.
- Turn on the directory view if you also want an alphabetical, searchable employee list on the same page.
Troubleshooting
- People are missing or the chart is flat
- Missing manager values in Entra ID. Fix the directory and the chart updates — no re-import needed.
- Photos do not load
- Users without a Microsoft 365 profile photo fall back to initials. Photos come from Graph, so they honor the tenant's photo policy.
- Access denied when the page loads
- The Graph directory-read request has not been approved in API access, or was approved for a different solution version.
FAQ
- Where does the hierarchy come from?
- The manager field in Entra ID, read live through Microsoft Graph. There is nothing to import or maintain separately.
- Can I export the chart?
- Yes, to PDF or PNG.
- Does it work on mobile?
- Yes — the layouts are responsive and it renders inside the SharePoint mobile app.
- Which languages does the interface support?
- Smart Org Chart 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. Directory data is 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.
