The Role Atlas is a row-per-role view of how your organisation's actual pay sits against the LiveRem market for the same role, at a target percentile you choose. It surfaces who's off-band, who's mispriced, and where the biggest gaps live — without having to step through individual employees.
This guide covers the Role Atlas screen end-to-end. For the structural side of compensation (defining your own ranges), see How to set up Salary Bands and How to use Salary Bands.
Before you start
Your HR and payroll systems should be connected — Role Atlas relies on current employee + salary data. See the Integration Guide.
Roles must be mapped to LiveRem job titles for market data to appear. Check the Mapping Page for any "for review" entries first.
Your organisation's target percentile lives in Settings → Organisation Details. The Atlas honours it by default; you can also override the percentile per session from the toolbar.
Your role needs ROLE_ATLAS_VIEW permission. Ask an admin via Settings → Users & Access if the screen doesn't load.
The KPI strip
Four cards at the top summarise the active roles at a glance:
Mapped roles — count of roles with a LiveRem mapping. Sub-line counts roles still waiting on a mapping.
Families — number of distinct job families across the mapped roles, with the total headcount as the sub-line.
Avg compa · p{N} — average compa-ratio (employee pay ÷ target pay) across the workforce at the current target percentile. Sub-line summarises whether the workforce sits below, on, or above target on average.
Roles off-band — count of roles in the Critical or Watch status (more on these below). The sub-line breaks the count down by status.
Family chips
Below the KPIs, every job family that has at least one active role becomes a chip. Each chip shows the family name, role count, and total headcount.
Click a chip to filter the table to roles in that family only.
Click All to clear the filter and see every role again.
Chip colours come from the chart-categorical palette so the same family always wears the same colour across the Atlas + Bands ladder.
Repricing alert
If any role's pay sits more than 15% below the market target, a red alert appears above the table calling out the worst offender by name. The alert disappears once every role is within tolerance of the target.
The alert always names the single worst-gap role — not the count of roles affected. Use the Roles off-band KPI for the total count.
Toolbar
The toolbar sits inside the role table card.
Search
Filters the table as you type. Matches against role name, LiveRem role mapping, and family.
Search and the family chip filter combine — searching inside a selected family narrows the results further.
Target percentile
A segmented control with five options — P25, P50, P60, P75, P90.
Changing this recalculates every row's Target column, status, and compa-ratio against the new percentile.
It also drives the dashed target · p{N} line on every BandViz cell.
This is a per-session override — the org-wide default stays in Settings → Organisation Details.
Sort
Order the table by:
Status — Critical → Watch → In band → Above (worst first).
Gap — largest absolute gap to target first.
Headcount — most people first.
View by
LiveRem role (default) — one row per LiveRem role, with all of your company titles that map into it bundled together. Best for comparing across the market.
Company title — one row per internal title, separately. Use this when two of your company titles map to the same LiveRem role but you want to see them individually.
[SCREENSHOT: Toolbar with search, target percentile, sort, and view-by controls.]
Legend
Just above the table header you'll see a short legend explaining the BandViz cell:
INT — your band — the grey track showing your employees' pay distribution for the role.
MKT — LiveRem market · P10–P90 — the purple track showing the LiveRem market range for the role.
target · p{N} — a dashed vertical line at the selected target percentile, spanning both tracks.
Market is always brand purple across LiveRem. Internal / Defined are always neutral. If a band ever wears purple in the app, that's market — never your own data.
The role table
One row per role (or per company title, depending on View by). The columns:
Role — the role name. Below it, the family chip and the mapped company titles (or LiveRem role, depending on view-by).
People — count of currently-employed people in the role.
Internal — your own median pay for the role.
Target · p{N} — the LiveRem market value at the chosen percentile.
Band · internal vs market — the BandViz cell: two stacked tracks (INT grey + MKT purple) on a shared salary axis with the target dashed line.
Compa — compa-ratio (internal median ÷ target). 1.00 means perfectly on target; 0.85 means 15% under; 1.15 means 15% over.
Status — coloured pill (see below).
Status pills
Critical (red) — internal median is more than 15% below the target. Underpaid relative to market.
Watch (orange) — internal median is 5–15% below target. Approaching underpayment.
In band (green) — internal median is within ±5% of target. Healthy.
Above (purple) — internal median is more than 5% above target. Not necessarily wrong, but worth understanding why.
Role detail panel
Click any row to open the detail panel for that role. The panel shows:
Gap callout — one-line summary of the dollar gap and percentage gap, tinted to match the status.
Mapped company titles — every internal title rolled into this LiveRem role (or the LiveRem role this internal title maps to, depending on view-by).
DetailBandViz — a wider, more detailed version of the band cell with full P10–P90 distribution shown for both internal and market.
Stats grid — internal min / median / max, market P25 / P50 / P75, headcount, average compa, Trust Score.
LiveRem pulse — a short narrative explaining the role's position and what to consider doing about it.
Adjust band — jumps to the Salary Bands screen so you can update your defined ranges in light of the gap.
See people — opens People Data filtered to employees in this role so you can review individual pay.
Close the panel with the × in the top-right or press Esc.
Export
The Export button in the top-right downloads the current filtered + sorted table as a CSV — every visible role with its internal pay, target, compa-ratio, status, headcount, and mapped titles. Useful for sharing with leadership or pulling into a comp-cycle planning sheet.
Benchmark filters
Role Atlas shares its benchmark filters with People Data and Salary Bands — industry, company size, revenue, community, exclude founders, new hires only, non-profits. Changing a filter recalibrates the LiveRem market values used by every row.
See How to use the People Data Page for the full filter reference.
Country
Role Atlas is country-aware: each role is rolled up at the employee's resolved country (or city, depending on the People Data Location toggle). Multi-country orgs see one row per (role, location) pair so each location compares against its own LiveRem market.
By following this guide, you'll be able to use the Role Atlas to spot under- or over-paid roles at a glance, compare against LiveRem market data at the percentile that fits your strategy, and drill into individual roles to plan band adjustments.