Map the committee, not the company
Ten well-chosen people beat two hundred contacts. Add the rest only when a deal makes them matter.
How-to
The whole flow, in order, with the decisions you have to make along the way. If you are a HubSpot admin, steps 1–3 are yours; if you are a sales rep, start at step 4.
Before you start. You need a HubSpot account with a Super Admin who can authorise apps, contacts that are associated with the company records you want to map, and — for the group view — parent/child associations between your company records. Rehnable does not need any data prepared in advance beyond that.
A Super Admin opens the install link and reviews the permissions HubSpot presents. Rehnable asks only for what it uses: read contacts, companies and deals; write contacts (that covers the reporting-line associations and the team property); create its own contact property; create static lists; read the portal's users and owners for seat assignment and task assignees; and write company associations for the group view.
Approve, and HubSpot redirects back with the install complete. There is no separate Rehnable account to create and no password to set — HubSpot is the identity provider for everyone in your portal.
Approve the whole permission set. If a permission is declined, the feature that depends on it fails at the moment you use it. Rehnable tells you which permission is missing rather than failing silently, but the fix is a re-install with the full set.
Installation is not passive. Rehnable bootstraps two things, once, automatically:
orgchart_team — a
single-line text field holding the team name. Ordinary property, usable in lists,
workflows and reports like any other.
Both are idempotent: if they already exist, nothing is duplicated. If they are ever deleted by accident, the next write re-creates them and retries automatically.
One more thing is created later, the first time a user adds a
placeholder (a position you know exists but cannot name yet):
a contact property called orgchart_placeholder, plus a static list
named "Rehnable placeholders" that every placeholder joins automatically.
Placeholders are ordinary contacts — named "Placeholder · <role>", never
given an email address, never marked as marketing contacts (so they cannot count
toward your marketing contacts quota). To exclude them from your own lists,
workflows and reports, filter on orgchart_placeholder = true — or
simply use the "Rehnable placeholders" list. Delete them like any other contact
if you no longer want them.
Rehnable is licensed per named user. Open Settings → Seats in the editor and pick the HubSpot users who should have access from your portal's real user list — the same names and email addresses you see in HubSpot's own user settings.
Seats are reassignable: when someone leaves the team, take their seat and give it to their replacement. A user without a seat cannot open the editor at all.
Worth knowing before you hand out seats: anyone with a seat can see every org chart the app can read, regardless of their own HubSpot record permissions. Treat a seat as "may see this account's stakeholders".
Go to any company record. The Rehnable card shows how many contacts are associated with that company and how many are already placed in the chart. Click Open org chart and the editor opens in a modal over the record.
The first time you open a company, the canvas may be nearly empty — that is correct. Rehnable does not invent a hierarchy from job titles; it shows what your CRM actually knows, which on day one is usually nothing. Building it is step 5 and 6, and it is faster than it sounds.
The contacts panel on the right lists every contact associated with the company. Search it, select the people who actually matter for this account, and place them on the canvas. Placing several at once is one action.
Placing is view state — it does not write anything to HubSpot. Nothing is committed until you draw a reporting line.
Do not place all 200 contacts. A stakeholder map is a decision about who matters. Start with the buying committee and the people around it; add more when a deal makes them relevant.
Drag a person's card onto the person they report to. That is the whole interaction. The moment you drop, Rehnable validates the move and writes the association to HubSpot — the layout re-flows and the change is live for everyone in your portal.
If a write fails halfway — a network drop, a permission problem — Rehnable tells you and shows the real state. It will never leave you with a chart that looks right on screen and wrong in the CRM.
Select the people who belong to the same function — Procurement, IT, Finance, Operations — and assign a team name. Their cards take on that team's colour, so the shape of the buying committee becomes visible across the reporting structure.
Team names are free text, which means consistency is yours to keep. Agree on a short list before you start, because Procurement and Purchasing will be two different teams. Rename or delete a team from the Teams tab and every contact follows.
Set a colour per team in Settings if the automatic one is not what you want; the colour applies for everyone in the portal, not just you.
Pick a heat parameter in the toolbar above the canvas:
| Mode | What it measures | Read it when |
|---|---|---|
| Combined | The mean of engagement and deal participation | You want one overall picture — this is the default |
| Engagement | Days since the contact's last sales activity, over a 120-day window | You are hunting for people going quiet |
| Deals | Number of deals the contact is associated with | You want to see who is commercially involved at all |
Scores are relative to the company you are viewing, not to your whole database. A small account still shows contrast between its warmest and coldest people instead of rendering uniformly cold. The number is printed on the card, so you are never guessing what a shade of orange means.
What to look for: a decision maker who is cold, a hot contact who reports to nobody you have mapped, a whole branch of the org with no activity, or one very hot person carrying every deal on the account — the classic single-threading signal.
Select people on the canvas — click, shift-click, box-select, or Select all visible — and a toolbar appears with what you can do with them:
A typical loop: switch to Engagement heat, box-select the cold half of the committee, create tasks for the account owner to re-engage them, done in under a minute.
If the account is a group of companies, switch from People to Group. The canvas draws the parent/child company structure that already exists in HubSpot, with each company carrying its own heat from last activity and open deals.
There is no Save button, because there is nothing waiting to be saved — every structural change was written when you made it. Close the modal and you are back on the company record.
| Persists in HubSpot | Resets when you close |
|---|---|
| Reporting lines (Manager / Direct report associations) | Which contacts you pinned to the canvas |
| Team assignments on contacts | Collapsed branches |
| Company parent/child changes | Zoom, pan and selection |
| Lists, tasks and property edits you created | The active heat mode |
Team colours, card properties and seats are portal settings — they persist for everyone.
| Key | Does |
|---|---|
| Cmd/Ctrl + Z | Undo the last write — a re-parent, a team assignment, a removal |
| Shift + click | Add a card to the selection |
| Drag on empty canvas | Box-select everything inside the rectangle |
| Backspace / Delete | Remove the selected cards from the chart (with a confirmation bar) |
| Esc | Close the open panel or dialog, or clear the selection |
| Enter | Confirm the focused dialog |
Shortcuts stay out of your way while you are typing — a keystroke in a text field is always just a keystroke.
Working practices
Ten well-chosen people beat two hundred contacts. Add the rest only when a deal makes them matter.
Write down five or six names before anyone starts tagging. Free text plus five reps equals fifteen variants of "IT".
Open the chart in the pipeline meeting. "Show me who else you are talking to" has a visual answer now — or a visibly empty one.
Switch to Engagement, select everyone cold, create tasks. It takes a minute and it is the highest-yield habit in the tool.
Customer reorganisations are exactly when your map is most wrong and most valuable. Dragging four cards is a five-minute job.
When an account changes owner, the org chart is the fastest briefing the new owner will get — and it is already in the CRM they inherited.
Troubleshooting
| Symptom | Most likely cause | Fix |
|---|---|---|
| The card says the company has no contacts | The contacts exist but are not associated with the company record | Associate them in HubSpot; Rehnable reads the association, not the email domain |
| Someone is missing from the contacts panel | Same cause — no company association | Add the association, then reopen the chart |
| The editor will not open | Your user does not hold a seat, or the app was uninstalled | Ask an admin to assign you a seat in Settings → Seats |
| A drop is refused | The move would create a reporting loop | Move the subordinate out first, then re-parent the manager |
| A write fails with a permission error | A required permission was not granted at install | Have a Super Admin re-install and approve the full permission set |
| Everything looks cold | No sales activity has been logged on these contacts in 120 days | That is a finding, not a bug — the account is genuinely quiet |
| Deleted contacts still appear as gaps | A reporting line points at a contact that no longer exists | Rehnable treats it as absent and reports it; re-parent the orphaned reports |
| A colleague's change is not visible | The chart was loaded before their write | Close and reopen the editor to reload from HubSpot |
| An orange banner says Test mode | The editor is running against sample data | Turn Test mode off to work against your real portal |
Still stuck? Email hello@rehnable.com with your portal ID and what you were doing — during the early access period you are writing to the person who built it.
Tell us your portal ID and we will get you set up.