Assigning roles (recruiter, hiring manager, etc.)
Overview: Effective team collaboration on Stafio.ai is underpinned by a robust system of user roles, each with specific
permissions. This article elaborates on "Getting Started" article 4, "Understanding User Roles & Permissions", detailing
the predefined roles and providing step-by-step guidance on how administrators can manually assign or change these
roles, or even create custom ones, to align with their team's responsibilities and ensure appropriate access levels.
1. Understanding Stafio.ai's Predefined Roles
Stafio.ai offers a set of predefined roles tailored to common recruitment functions, each with specific capabilities
across various actions within the platform. Understanding these roles is crucial for efficient workflow and data
security.
- Administrator (Admin):
- Access: Full and unrestricted access to all features, data, and settings within the Stafio.ai workspace.
- Permissions Include: Managing company profile settings, inviting and managing all team members (including
roles), creating/editing/publishing/deleting all jobs, managing all candidates, assessments, interviews, and
full access to analytics, reports, billing, and the ability to define custom user roles.
- Best For: Head of HR, Talent Acquisition Leads, System Administrators, or Business Owners.
- Recruiter:
- Access: Comprehensive access to day-to-day recruitment tasks.
- Permissions Include: Creating, publishing, editing, and managing job postings; sourcing, inviting, and managing
candidates; assigning assessments, scheduling interviews, and managing candidate pipelines; collaborating on
evaluations; and access to job-specific analytics. They can archive jobs but generally not permanently delete
them.
- Best For: Individual recruiters, talent specialists, and talent acquisition managers.
- Hiring Manager:
- Access: Focused access on reviewing candidates and making hiring decisions for their specific assigned
roles/departments.
- Permissions Include: Viewing assigned jobs; reviewing candidate profiles; providing feedback and evaluations;
participating in and managing interview schedules they are part of. They have limited access to settings and no
access to team management or billing.
- Best For: Department heads, team leads actively hiring for their teams.
- Interviewer (or Reviewer):
- Access: Limited access, focused solely on candidate evaluation for specific assignments.
- Permissions Include: Accessing specific candidates or interview schedules they are assigned to; conducting
interviews and submitting interview feedback forms. They have no access to job creation, candidate sourcing
(beyond assigned profiles), team management, or billing.
- Best For: Employees from any department participating in interviews or candidate reviews.
- Viewer:
- Access: Read-only access to specific data within the platform.
- Permissions Include: Viewing jobs, candidate pipelines, and basic reports they are granted access to. They
cannot make any changes, invite users, access sensitive settings, or perform any operational actions.
- Best For: Executive stakeholders, legal teams, or auditors who require oversight without operational
involvement.
- Understanding Granular Permissions (Capabilities): As an Administrator, you can view how permissions are defined for
various actions. This includes capabilities like "View (Own)" (view items they created or are assigned to) vs. "View
(Global)" (view all items of that type across the workspace), along with "Edit," "Create," "Restore," and other
specific actions like "Delete," "Publish," or "Archive".
2. How to Assign/Change a User's Role
Assigning or changing a team member's role is a manual administrative action performed by an Administrator.
- Steps to View/Change a User's Role:
- As an Administrator, navigate to Settings > User Management from your dashboard.
- Locate the team member whose role you want to view or change in the list.
- Click the three-dot menu (â‹®) or an "Actions" button next to their name and select "Change Role" or "Edit
Permissions".
- Select the new role from the dropdown menu and Save your changes.
- Manual Intervention Point: Only users with Administrator permissions can change user roles, highlighting the manual
control over access levels.
3. Creating Custom Roles (for Administrators)
If the standard roles don't perfectly fit your organizational structure, Administrators can manually create custom roles
with tailored permissions.
- Steps to Create a Custom Role:
- Navigate to Settings > User Management.
- Look for an "Add New Role" section or button on the screen.
- Enter a unique Role Name (e.g., "Senior Recruiter - Tech," "HR Generalist").
- Systematically go through the list of "Actions" (e.g., Applications, Jobs, Interviews) and check the specific
"Capabilities" (View, Edit, Create, etc.) you want to grant for that role.
- Click "Save Role" or "Create Role" to finalize.
- This new custom role will then be available in the dropdown when inviting new members or changing existing user
roles.
- Manual Intervention Point: The configuration of custom roles is a manual, granular process performed by an
Administrator to ensure precise permission alignment.
4. Best Practices for Role Management
- Principle of Least Privilege: Always assign the minimum permissions necessary for a user to perform their job
effectively. This enhances security.
- Regular Audits: Periodically review assigned roles and custom role definitions to ensure they remain appropriate as
responsibilities or team members change.
- Training & Communication: Ensure all team members understand their role's permissions and limitations to prevent
confusion and misuse.
Troubleshooting & Tips:
Issue: User can't perform an action (e.g., post a job, view certain candidates)?
Suggested Fix:Â The user likely doesn't have the necessary permissions for their assigned role. Verify their assigned
role in Settings > User Management. If they need higher permissions, an Administrator must update their role.
Issue: Incorrect data being viewed by a user (e.g., can see all applications when they should only see their own)?
Suggested Fix:Â Review the user's assigned role and the specific "Capabilities" (e.g., "View (Global)" vs. "View (Own)")
granted to that role for the relevant action. Adjust their role or permissions if necessary. If the issue persists,
contact Support@stafio.ai.
Issue: "Add New Role" option not visible?
Suggested Fix:Â Only users with Admin permissions have the ability to create or modify custom roles. If you need a custom
role, contact your workspace administrator.
Issue: User's permissions seem stuck/not updating after role change?
Suggested Fix:Â Ask the user to log out and log back in to refresh their session. If the problem persists, clear browser
cache and cookies. If still an issue, contact Support@stafio.ai.