Definition
Roles is a Setup page where administrators define the role hierarchy, which controls record visibility through the data access model. Users higher in the hierarchy can automatically see records owned by users below them. The role hierarchy is also used for forecasting rollups and sharing rule definitions.
Real-World Example
The admin at Pinnacle Analytics builds a role hierarchy with CEO at the top, VP of Sales and VP of Service below, Regional Managers under each VP, and Sales Reps and Service Agents at the bottom. The VP of Sales can now see all Opportunities owned by reps in her organization, while reps can only see their own records.
Why Roles Matters
The Roles Setup page in Salesforce is the administrative interface where admins define and manage the role hierarchy that governs record visibility across the organization. From this page, admins can create new roles, rename existing ones, rearrange the hierarchy by dragging roles to new positions, and assign users to specific roles. The page also shows how roles connect to forecasting rollups and sharing rule targets. It is the single source of truth for the organizational visibility structure, and changes made here immediately affect which records users can access throughout the system.
Maintaining the Roles page becomes increasingly important as organizations grow, restructure, or undergo mergers and acquisitions. Admins must update the hierarchy when new departments are created, management changes occur, or business units are reorganized. A stale role hierarchy that does not reflect the current organization leads to inappropriate data access — either too permissive or too restrictive. The Roles page is also critical for audits, as compliance officers often request the hierarchy diagram to verify that data visibility aligns with the company's access control policy. Best practice is to review and update the Roles page quarterly, treating it as a living document rather than a set-and-forget configuration.
How Organizations Use Roles
- Pinnacle Analytics — Pinnacle's admin built a role hierarchy with CEO at the top, VPs of Sales and Service below, Regional Managers under each VP, and individual reps at the bottom. Using the Roles page, she verified that the VP of Sales can see all Opportunities across regions while individual reps are limited to their own records. This took 20 minutes to configure and replaced a complex spreadsheet-based access tracking system.
- Ironclad Legal Services — After acquiring a smaller firm, Ironclad's admin used the Roles page to integrate the acquired team into the existing hierarchy. She created a new branch under the VP of Operations for the 35 incoming users, assigned them roles matching their seniority levels, and validated that data visibility rules applied correctly. The migration was completed in a single afternoon without disrupting existing users' access.
- Solaris Energy — Solaris undergoes quarterly reorganizations as they expand into new markets. Their admin schedules a Roles page review every quarter, updating the hierarchy to reflect new regional structures and management changes. She exports the hierarchy diagram for the compliance team, who use it to verify that data access patterns meet SOC 2 audit requirements.