Skip to content

Organisation Chart on the Portal

Ed Mozley edited this page Nov 21, 2026 · 4 revisions

🏢 Organisation chart on the portal

An Organisation page in the self-service portal showing who reports to whom in the person's own company. It is the same chart as People → Organisation - the tree, the boxes-and-lines chart, search, zoom and export - with what a portal user should not see taken out. It is built from the manager FreeITSM holds against each person, set by hand in Tickets → Users or brought in by a directory sync.

Requested in discussion #414 by JB-SRB. Developers: Organisation chart on the portal - Developer Guide.


Switching it on

System → Self-service portal, under What the portal lets people do, Organisation chart:

Choice Who gets the Organisation tab
Off (the default) Nobody
Everyone Everybody who signs in to the portal
Only members of chosen People groups Members of the People groups you tick. A group that is no longer being imported lets nobody in

Press Save. The People module must be switched on as well: switching People off for the install takes the tab away too.

Why it is off by default. An internal IT department usually wants everybody to see the organisation. A service provider whose portal serves many customer companies must not find that its customers can suddenly browse each other's staff - so nobody gets it until somebody chooses to. This is the same rule promised for portal People lookups on discussion #330.

What people see

Everything the analyst chart offers - Tree (Cards, Compact, Columns) and Chart (boxes and lines, Cards or Compact, top to bottom or left to right, levels, zoom, Dim the others, Export as PNG, SVG, PDF, CSV, JSON or XML) and Mouse and keyboard - opened on the person themselves, marked You. What is different:

People → Organisation (analysts) The portal
Whose people Every company the analyst can access The reader's own company only
Leavers Hidden unless Show leavers is ticked; a leaver who still has a team is always shown Never - there is no Show leavers box, and a leaver's team starts at the top instead
Side panel Who they are, how to reach them (email, phone, office...), a link to their page Who they are, who they report to and their team - no contact details, no page to open
Gaps Listed in the sidebar Not shown - they are an administrator's to-do list
Search Name, email, job title... Name, job title or department

Things worth knowing

  • Everybody is on it somewhere. Somebody with no manager and nobody reporting to them has no place in the tree; picking them in search shows them on their own in the chart, with a line saying why. (The analyst chart does the same.)
  • Somebody with no name is shown by their email address (or sign-in name), so a missing name is visible and gets fixed rather than the person silently not being there. Nobody else's email address is ever shown.
  • A manager the reader cannot see - somebody who has left, or who belongs to another company - is never named. Their team starts at the top of the chart instead.
  • Fixing a reporting line happens where it always has: on the person's record in Tickets → Users, or in the directory a sync reads. Nothing on the portal changes one.

The portal's own Help page gains a section on the chart, for people who have the tab.

Decided

  • 2026-11-20 (Ed): off by default, for everybody or chosen People groups, own company only, no contact details - the shape promised on #330.
  • 2026-11-20 (Ed): always show everybody, even somebody with no name - by their email address - "that way at least you know there's a problem to fix".
  • 2026-11-21 (Ed): the portal shares the People module's chart code rather than having its own ("can you not just share the code from the org chart in the people module so there isn't duplicate code"). The first build was a lean list-style tree of its own; it was replaced before release.

Related pages

FreeITSM

Getting Started

Modules

Multi-tenancy (planned)

Responses to feedback

Blue sky thinking

Bugs resolved

Pull requests

Links

Clone this wiki locally