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

Quick answer

How do you display an org chart in SharePoint Online?

SharePoint's built-in Organization chart web part shows one person's reporting line, read from the manager field in Entra ID. For a full, navigable chart and a searchable directory, add an SPFx web part that reads Microsoft Graph live, such as the free SharePoint Smart Org Chart. Accuracy always depends on manager fields being filled in Entra ID.

SharePoint Org Charts and People Directories: Complete Reference

Last updated · By Sean Regan

1. Where the data comes from

Every SharePoint org chart ultimately reads two Entra ID user attributes: manager (a single-valued reference to another user) and directReports (the reverse). If those fields are unpopulated, no visualization will render a meaningful chart. Populate the manager attribute either from your HRIS via an inbound Entra provisioning connector, or with a lightweight PowerShell script if you keep the mapping in a CSV.

2. The Microsoft Graph endpoints

  • GET /users/{id}/manager — a user's manager[2].
  • GET /users/{id}/directReports — a user's direct reports[1].
  • GET /users/{id}/photo/$value — profile photo[3].
  • GET /users?$select=id,displayName,jobTitle,department — bulk directory pull.

All four are covered by the delegated User.Read.All scope. An SPFx web part running in the current user's context can call them via MSGraphClientV3 without any client secret.

3. The out-of-the-box Organization web part

SharePoint ships an Organization web part that displays the manager chain for one specific user: you enter a name, and it shows that person, their manager, their manager's manager, and their direct reports. It cannot browse the tree, cannot search, cannot filter by department, and cannot render Teams presence. It is fine as a signature block on a person's profile page and unsuitable as an intranet directory.

4. Photos, contractors, and edge cases

  • Missing photos — /photo/$value returns 404 when the user has never uploaded one. Fall back to a colored monogram, not a stock avatar.
  • Contractors and guests — external users normally have no manager attribute set. Either skip them or attach them to their sponsor account manually.
  • Dotted-line reports — Entra ID has no first-class dotted-line concept. Model these with a directory extension attribute (e.g. extension_dottedLineManagerId) and merge on read.
  • Deleted managers — a user whose manager was soft-deleted still has the manager reference, but the Graph call returns 404. Handle gracefully.

5. Web-part options

  • SharePoint OOB Web Part — first-party, free. Single-person view only.
  • Smart Org Chart & Directory — open-source SPFx web part. Full browsable tree, searchable directory, Teams presence, PDF/PNG export.
  • Plumsail Org Chart — paid annual subscription, feature-rich, hosted config UI.
  • OrgChart Now — enterprise HR platform with workforce planning and HRIS connectors.

6. When you actually need HRIS integration

If the org chart on your intranet is the source-of-truth for HR headcount reporting, buy an HR platform (OrgChart Now, ChartHop, Pingboard). If the chart's purpose is "help people at the company find each other" — and HR runs their own reporting separately — a Graph-backed SPFx web part is more than enough and skips the annual bill.

7. Choosing an approach

A rule of thumb:

  • Single-person signature block → OOB Organization web part.
  • Company-wide, browsable directory on the intranet → Smart Org Chart or Plumsail.
  • Workforce planning, scenario modeling, HRIS as source of truth → OrgChart Now / ChartHop.

8. References

  1. [1] Microsoft Graph — List directReports
  2. [2] Microsoft Graph — Get manager
  3. [3] Microsoft Graph — Get profile photo
  4. [4] Microsoft Learn — SharePoint Framework (SPFx) developer docs

Related tools & comparisons

The SharePoint org chart guides

Understand what SharePoint ships with, build a live chart from Microsoft 365 data, then compare the options.

Building out your intranet?

Let our team design and build your SharePoint intranet

Intranet design, integrations, Power Automate workflows, and Microsoft 365 strategy, plus paid support packages for the tools on this site.