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

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. 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. 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.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. 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. 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. 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. 2.Set the root person

    Start at the CEO for the full tree, or at a department head for a team-scoped chart.

  3. 3.Choose the layout

    Vertical or horizontal, with the number of levels shown by default. Deeper branches load on demand.

  4. 4.Turn on search and presence

    Enable the searchable directory and Teams presence so the chart is also a people finder.

  5. 5.Apply your theme

    Match the site theme and card fields (title, department, location) to what your organization actually uses.

  6. 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.

Install another tool