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/$valuereturns 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] Microsoft Graph — List directReports
- [2] Microsoft Graph — Get manager
- [3] Microsoft Graph — Get profile photo
- [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.
Build
Step-by-step install and configuration with screenshots, in about 10 minutes.
30 interface languages, picked automatically from each user's Microsoft 365 language.
Contractors, consultants and board members without Entra ID accounts — added manually or by CSV import.
Theming, department filters, card fields and directory view.
A searchable staff directory built live from Entra ID, with A–Z, department and office filters.
When the built-in People web part is enough, and when you need a live directory.
Which to use for a SharePoint employee directory, and when PnP search is the better fit.
The free, MIT-licensed SPFx web part: live Graph data, Teams presence, PDF/PNG/Excel export.
Compare
Why the People and Organization web parts fall short of a real reporting hierarchy.
Free and paid options side by side, with pricing and licensing.
Live charts without a Visio license or a manual redraw every reorg.
