Skip to main content

Org Chart -- Common Questions and Edge Cases

A quick reference for when the Org Chart behaves in a way you did not expect. If something looks off, your answer is likely here.

Written by Amogh Balikai

A contact is missing from the Org Chart. Why?

The Org Chart only displays contacts who have at least one reporting relationship set, either they report to someone or someone reports to them, or who have been added as a board member.

If a contact is not showing up in the reporting hierarchy, it means no "Reports To" relationship has been defined for them yet. To add them to the chart, open their contact profile and set the "Reports To" field. Once saved, they will appear in the chart automatically. To add a contact to the Board block instead, see How to Add Board Members to a Company's Org Chart.


I changed a contact's company. What happens to their org chart relationships?

This depends on your CRM settings.

By default (setting is OFF): When a contact's company is changed, they are removed from the org chart of their previous company. Any contacts who reported to them will no longer show those relationships in the chart.

If the setting is turned ON: The contact stays in the org chart of their original company even after the company field is updated.

To find this setting: Go to Settings > CRM Settings and look for:

"Do not remove Contact from existing Org Chart if their company name changes"

Toggle this on if you want to preserve org chart relationships when reassigning contacts between companies. Toggle it off if you want the chart to always reflect the current company assignment only.

Recommendation: For most agencies, keeping this OFF is the safer default, it keeps your charts clean and accurate. Turn it ON only if your team frequently updates company fields as part of a data migration or merge and wants to preserve the visual structure in the interim.


A contact I deleted was a manager with direct reports. What happened to those contacts?

When a contact is deleted, their node is removed from the Org Chart entirely. Their former direct reports do not become orphaned or disconnected, they simply lose that upward relationship and will no longer appear in the chart unless they have other relationships defined.

The chart will never show a broken or empty node in place of a deleted contact. If you want the direct reports to stay visible, reassign their "Reports To" field to a different contact before deleting the original.


I tried to create a reporting relationship and got an error. What went wrong?

There are two validation rules that will block a relationship from being saved:

1. A contact cannot report to themselves. Selecting the same contact in the "Reports To" field as the contact you are editing will throw a validation error. This is expected behaviour.

2. Circular references are not allowed. A circular reference is when the reporting chain loops back on itself, for example: Sarah reports to James, James reports to Priya, and Priya reports to Sarah. Recruiterflow detects this and blocks the save with the message:

"Cannot create circular reporting relationships."

To fix it: Review the existing chain before assigning the new relationship. Break the loop by editing one of the intermediate relationships first, then reassign.


Can a contact report to someone at a different company?

No. The "Reports To" field only shows contacts from the same company. You cannot create a cross-company reporting relationship.

If you need to reflect a reporting structure that spans companies (for example, a parent company and a subsidiary), you would need to consolidate those contacts under a single company record first.


Can a contact appear in more than one Org Chart?

Not in the reporting hierarchy. A contact belongs to one company at a time for reporting purposes, and the Org Chart's reporting section is scoped to that company. If a contact's company changes, their org chart visibility follows the company change (or the CRM setting, as described above).

Board membership works differently: a contact can be a board member on more than one company's Org Chart at the same time, since board membership is tracked as a separate company association on their profile. See Board Members FAQ for details.


How do I remove a reporting relationship without deleting the contact?

Open the contact's profile, find the "Reports To" field, and clear the selection. Save the profile. The relationship is removed immediately, and the chart updates to reflect the change.

You cannot delete relationships from within the Org Chart view itself, all edits happen at the contact profile level.


A board member's Company profile was deleted. What happens to their board membership?

The board membership is removed from their Contact profile along with the Company profile. This follows the same behavior as any other company association on a contact.


If I remove a contact from the Board block, does it affect their reporting relationships?

No. Board membership and reporting relationships are tracked separately. Removing a contact from the Board block only removes their board-member company association. Any "Reports To" relationship they have stays exactly as it is.


I removed a company from a contact's profile directly. Why did they disappear from that company's Board block?

Board membership syncs in both directions between the Org Chart and the Contact profile. Removing the company from the contact's profile removes them from that company's Board block automatically, and adding it back would add them again.

Did this answer your question?