tcviz VISUALS TO POWER BI
Org Chart by TCViz
Support & Documentation
Visual v1.0.0.0  ·  docs updated 11 Oct 2026  ·  what's new

Free — every feature, no licence, no watermark. Supported Power BI features: cross-filtering by a person or their whole team, Ctrl+click multi-select, highlighting · bookmarks · standard and report page tooltips · context menu · conditional formatting (fx) on card colour · format on the canvas (on-object) · keyboard navigation through the tree with ARIA labels · high contrast · number formats from the model · 12 panel languages · data streaming past 30,000 rows in the Power BI service. Org chart: employee and manager IDs, photos, vacancies, dotted-line managers, collapse and expand, breadcrumb navigation, search, zoom, minimap, compact layout, department groups, 5 style templates.

Quick Start

1. Add the visual to your report

In Power BI Desktop, go to the Visualizations pane → click the three dots → Get more visuals → search for Org Chart by TCViz.

2. Two fields draw the chart

Drag the person's ID to Employee ID and their manager's ID to Manager ID. The person with an empty Manager ID is the top of the chart. That is all the visual needs: it works out the levels itself, however deep the organisation is.

3. Make the cards useful

Add Name, Job title, Department and Photo. Put a measure in Value (cost, FTE, sales…) to show it on each card and add it up for each manager's team.

4. Pick a look

Format → Style template: Clean, Corporate, Colorful, Minimal or Compact. Anything you set by hand wins over the template.

Field Wells

WellAcceptsWhat it does
Employee ID1 columnA unique ID for each person or position. Required.
Manager ID1 columnThe Employee ID of each person's manager. Empty, or the person's own ID, means the top of the chart. Required.
Dotted-line manager ID1 columnOptional second manager (matrix or project reporting). Drawn as a dashed curved line and shown in the tooltip.
Name1 columnMain text of the card. A row with an empty name is shown as a vacancy, with a dashed border.
Job title1 columnSecond line of the card.
Department1 columnColours the cards and can group teams in boxes.
Photo1 columnA Base64 image stored in your model (data:image/jpeg;base64,…; PNG, JPEG, GIF, SVG or WebP). Without a photo, the card shows the person's initials. Web links are not loaded, on purpose — see Privacy.
Value1 measureShown on each card and added up for each manager's whole team (tooltip and line labels).
Color value1 measureColours the cards on a gradient when Colors → Color by is Color value.
TooltipsmeasuresExtra values in the tooltip.

Limits: Power BI sends up to 30,000 rows per block. In the Power BI service the visual asks for the next blocks automatically; Power BI Desktop only sends the first block to custom visuals, and the warning icon in the visual header says so.

Format Pane

Style template

None, Clean (default), Corporate (left band, square photos, shadow), Colorful (cards tinted by department), Minimal (no borders, curved lines) and Compact (small cards without photos). A template only fills in what you have not changed yourself.

Cards

SettingDefaultNotes
Card width / height200 / 6480–600 and 28–300 pixels.
Show photo · Photo shape · Photo ringOn · Circle · OnCircle, Rounded or Square. The ring takes the department (or level) colour, so the palette shows on cards with photos too.
Show job title · Show departmentOn · Off
Team sizeDirect reportsNone, Direct reports, Whole team, or both.
Show valueOnThe Value measure, formatted as in your model.
Font · Name size · Name color · Text colorSegoe UI · 12
Card colorWhiteSupports fx conditional formatting: rules, gradient or a field value give each card its own colour.
Border color · width · Corner radius · Shadowgrey · 1 · 8 · Off
Department bandTopA band in the department (or level) colour: Top, Left or None.

Layout

SettingDefaultNotes
OrientationTop to bottomOr Left to right.
CompactOnPeople without reports are listed in a column under their manager, so a wide team fits on screen. Top to bottom only.
Space between cards · between levels16 · 40
Open levels to fitOnOff: Levels open at start decides (0 opens every level).
Group departmentsOffDraws a box, in the department colour, around each department's team.
Click selects the whole teamOnClicking a manager filters the page by everyone under them. Off: just that person.

Lines

Shape: Elbow, Straight or Curved · Color, Width, Dashed · Department color (each line takes the colour of the team below) · Show dotted-line managers · Label on each line: the size of the team below or its total value.

Colors

Color byWhat you get
DepartmentEach department its own colour (band, initials, lines, groups).
LevelEach level of the organisation its own colour — useful without a Department field.
Color valueCards on a gradient from Low color to High color by the Color value measure (or Value).
Single colorCard color for every card.

Tint cards fills each card with a shade of its department or level colour; Tint strength % (default 22) sets how strong. 16 palettes, 4 of them colour-blind safe. Background: optional; empty keeps the visual transparent.

Toolbar

Show or hide the toolbar, search, minimap and breadcrumb. On small tiles the toolbar and search hide themselves.

Format on the canvas

In format mode, click a card's text to change font, size and colour, the card itself for fill and border, or a line for its colour and shape — without opening the Format pane.

Selection & filtering

Accessibility

Real data: what the chart does with it

Troubleshooting

What you seeWhyWhat to do
The start page with three stepsEmployee ID or Manager ID is empty.Both fields are required.
Everyone at the top, side by sideManager ID values do not match Employee ID values (text against numbers, leading zeros, spaces).Use the same column type and format for both IDs. The warning icon lists the IDs it could not find.
Photos do not appearThe Photo value is a web link, is longer than Power BI's 32,766-character limit for a text value, or does not start with data:image/.Store small images as Base64 (a 96×96 JPEG is about 5,000 characters).
Only two levels are openOpen levels to fit keeps names readable.Expand branches by hand, zoom in, or turn it off and set Levels open at start.
A warning icon about rows in DesktopPower BI Desktop sends custom visuals only the first 30,000 rows.Publish to the Power BI service.
fx on Card color does nothingColor by is Color value, which takes the colour from the measure.Set Color by to Department, Level or Single color.

FAQ

Is it really free?

Yes. Every feature on this page is included, with no licence, no limit on the number of people, no trial and no watermark.

Is it only for people?

No. Any parent–child table works: a chart of accounts, cost centres, legal entities, a product tree. Put the item's ID in Employee ID and its parent's ID in Manager ID.

How deep can the organisation be?

There is no level limit: the levels come from the Manager ID chain, not from separate columns.

How do I show a vacancy?

Add a row for the position with an Employee ID, a Manager ID and an empty Name. It is drawn as Vacant with a dashed border.

Someone reports to two managers. Can I show both?

Yes: the main manager in Manager ID and the second one in Dotted-line manager ID. The second link is drawn as a dashed curved line, and the tooltip names it.

How do I get photos into the model?

As Base64 text: a column whose values start with data:image/jpeg;base64,. Keep them small — Power BI cuts text values longer than 32,766 characters; a 96×96 JPEG is about 5,000. Set the column's data category to Image URL if you also want to see the photos in a table.

Why are web links to photos not loaded?

The visual has no network permission, so it cannot load anything from outside your report — and cannot send anything either. See Privacy.

What do bookmarks remember?

Power BI bookmarks keep a custom visual's selection: applying one selects the same people again, opens their branches and centres them. The branches you open by hand and the team you focus on are kept while you work — through filters and refreshes — but a bookmark does not store them; that is how bookmarks work for all custom visuals.

Clicking a manager filters everyone under them. Can it filter just the manager?

Turn off Layout → Click selects the whole team.

Can I drill down?

The org chart is already the hierarchy: open a branch, or use Show only this team to go into it, and the breadcrumb to come back up. Power BI's drill buttons apply to hierarchies of columns, which an employee–manager table does not have.

Which languages is the Format pane in?

English, Spanish, French, German, Italian, Portuguese (Brazil and Portugal), Dutch, Polish, Japanese, Simplified Chinese and Korean. It follows the language of Power BI.

Does my data leave Power BI?

No. The visual has no network permission: it cannot send or load anything. See Privacy.

Contact & Support

✉️

support@tcviz.com

Questions, ideas or a bug? Email support@tcviz.com, ask in GitHub Discussions or open an issue. Please include your Power BI version and, if you can, a screenshot without personal data.

Use cases Changelog