How-to

From install to a finished stakeholder map

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.

Install Rehnable

A Super Admin installs Rehnable from its HubSpot App Marketplace listing 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.

HubSpot's install screen, Connecting Rehnable to HubSpot: the Rehnable and HubSpot logos, Review what Rehnable can access in your HubSpot account, and a list headed Required (10) that starts with View properties and other details about companies.
  1. The ten permissions Rehnable asks for
  2. Scroll the list to review them all

The full list, with what each permission is used for, is on the Security page.

What gets created in your portal

Installation is not passive. Rehnable bootstraps two things, once, automatically:

  • A labelled association pair between contacts — "Manager" and "Direct report". This is how a reporting line is stored. HubSpot allows up to 50 custom association labels between two contact records, so this uses one of them.
  • A contact property called 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.

HubSpot's Data Model Builder for the Contacts object, on the Associated objects and labels tab. The Contacts row lists the labels Direct report and Manager.
  1. The Contacts object's Associated objects and labels tab
  2. The Manager and Direct report pair Rehnable creates

Assign seats

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.

The list shows each user's HubSpot seat, so you can filter to everyone with a Sales Hub seat and assign them in one step, up to your plan's seat count.

Seats are reassignable: when someone leaves the team, take their seat and give it to their replacement. Once you have a subscription, a user without a seat cannot open the editor; during the free trial, everyone in your portal can.

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".

The Seats panel: 1 of 15 seats assigned, a search field, and a table of HubSpot users. Two users are ticked, the toolbar above reads 2 selected with an Assign seat button, and the Rehnable seat column shows Assigned for the admin and a dash for the others.
  1. Tick the users who should have access
  2. Assign seat

Remove seat works the same way, and asks before it removes anything.

Open your first chart

Go to any company record. The Rehnable card there is deliberately thin — a single line of text and one button, doing no CRM work of its own. Click Open org chart and the chart opens in a window over the record, with everything else happening inside it.

A HubSpot company record with the Rehnable card in the middle column: one line of text and an Open org chart button.
  1. The Rehnable card on the company record
  2. Open org chart

The first time you open a company, the canvas is usually 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. The empty canvas lists the three steps to get going, and the ? button at the top of the editor brings back the quick start and the keyboard shortcuts at any time. Building the chart is steps 5 and 6, and it is faster than it sounds.

Place the right people

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.

The editor on a company with no reporting lines yet: the canvas shows three numbered getting-started steps, and three contacts are ticked in the Contacts panel on the right, above a Place on canvas (3) button.
  1. Tick the people who matter
  2. Place on canvas

Or drag a single contact from the panel straight onto the canvas.

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.

Build the reporting lines

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.

An org chart of eight people with the Contacts panel folded away. An arrow runs from Anders Falk's card, marked Drag, to Sara Holm's card, marked Drop here.
  1. Drag the person's card
  2. Drop it on their manager

Drop, and the line is drawn and written to HubSpot in the same moment.

  • To move someone to a new manager, drag them onto the new one; the old reporting line is archived and the new one created.
  • A HubSpot super admin can choose, under Settings, to remove the unlabeled association HubSpot keeps between a contact and the old manager when a reporting line moves, but only when no other association label connects them.
  • The group view works the same way: when you move or detach a company, HubSpot keeps an unlabeled association between the company and its old parent company, and the toast offers to remove it, but only when no other association label connects them.
  • To take someone out of their reporting line, tick their card and press Remove in the toolbar (or Backspace). Rehnable asks before it writes, and the contact itself is never deleted.
  • To put someone at the very top, such as a new CEO above everyone already mapped, tick a single card that has no manager yet and choose Make top manager: everyone currently at the top then reports to them.
  • Dropped a card on empty canvas? It comes loose from its manager, and the message that appears lets you undo it. Its own reports stay under it; a card without reports is marked Not yet connected. A small nudge, a drop that lands on more than one card, or a card that has no manager springs back.
  • You cannot create a loop. Dropping a manager onto their own subordinate is refused, on the canvas and again on the server.
  • Made a mistake? Cmd/Ctrl+Z, or the Undo button on the toast that appears after each write.

If a write fails halfway, for example after a network drop or 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.

Tag teams

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.

Two contacts ticked in the Contacts panel, the team name Platform typed into the Team field, and the Assign (2) button next to it.
  1. Tick the team's members
  2. Type the team name
  3. Assign

Set a colour per team in the Teams tab if the automatic one is not what you want; the colour applies for everyone in the portal, not just you.

Read the heatmap

Pick a heat parameter in the toolbar above the canvas:

The org chart in Combined heat mode. Each card has a coloured stripe on its left edge and a line of text such as 126 d · 1 deal; the Cold to Hot key sits beside the heat-mode buttons.
  1. Pick the heat mode
  2. The cold-to-hot key
  3. The value in words on every card

Hover any control, or tab to it, for a one-line explanation.

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 HubSpot's Last contacted date — the last logged call, meeting, one-to-one email, chat or message with the person — 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. And the card states the underlying value alongside the colour — days since anyone contacted the person, or how many deals they are on, whichever the active mode is showing — 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.

Act on the selection

Select people — tick the box on their card or in the contacts panel, hold Shift and drag a box around several cards, or use Select all visible — and a toolbar appears with what you can do with them:

  • Create a static list — name it, and it exists in HubSpot immediately, ready for a sequence or workflow.
  • Create tasks — one per contact, with a shared title, notes, due date, priority, type and assignee.
  • Edit properties — set the same value on the whole selection; the picker only offers properties that are actually writable.
  • Remove — takes them out of the chart by clearing their reporting lines, after a confirmation; the contact itself is never deleted.
Two cards ticked on the org chart and the selection toolbar at the bottom of the canvas: 2 selected, Create list, Create tasks, Edit properties and Remove.
  1. Tick the cards
  2. Choose what to 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.

Work a corporate group

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.

  • Click a company to drill into it; use the breadcrumb to come back up.
  • Drag a company onto another to set its parent — one parent per company, cycles refused.
  • Search for a company that should belong to the group and attach it without leaving the editor.
  • Switch to the group's contacts to see people across every company in the structure.
The Group view: three company cards stacked parent to child, each with its contact and open-deal counts and a heat line such as 128 d · 4 deals, the current company outlined in blue.
  1. Switch from People to Group
  2. Each company carries its own heat

Close, and what persists

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.

Keyboard shortcuts

Key Does
Cmd/Ctrl + Z Undo the last write — a re-parent, a team assignment, a removal
Shift + drag on empty canvas Box-select every card inside the rectangle (a plain drag pans the canvas)
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 open confirmation bar

Shortcuts stay out of your way while you are typing — a keystroke in a text field is always just a keystroke. The same list is one click away inside the editor, under the ? button at the top.

Working practices

How teams get value out of this in week one

Map the committee, not the company

Ten well-chosen people beat two hundred contacts. Add the rest only when a deal makes them matter.

Agree on team names first

Write down five or six names before anyone starts tagging. Free text plus five reps equals fifteen variants of "IT".

Make it part of deal review

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.

Use engagement heat before a QBR

Switch to Engagement, select everyone cold, create tasks. It takes a minute and it is the highest-yield habit in the tool.

Re-map after every reorg

Customer reorganisations are exactly when your map is most wrong and most valuable. Dragging four cards is a five-minute job.

Hand over accounts with the chart

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

When something looks wrong

Symptom Most likely cause Fix
The contacts panel is empty on a company you know has people 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 call, meeting, one-to-one email, chat or message has been logged with 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 — you are writing to the person who built it.

Ready to map your first account?

A Super Admin installs it from the HubSpot App Marketplace listing, and the chart is one button away on every company record.