DOCS
Community open_in_new Support
  • Spanish (Mexico) check
  • Portuguese (Brazil) check
  • English (US) check
Login

Products

Case studies open_in_new

Acquire

  • Talent AcquisitionCreate requisitions and manage hiring
  • Candidate ExperienceDeliver personalized candidate journeys
  • AI InterviewerConduct and score AI interviews
  • Talent FlexMatch and contract gig talent

Develop

  • Talent ManagementGuide employee growth and mobility
  • Workforce ExchangeConnect job seekers with employers

Plan

  • Resource ManagementMatch employees to open projects
  • Reporting & AnalyticsBuild reports across talent data

Platform

  • Talent Intelligence PlatformPower talent decisions with AI
  • App platformREST APIs and webhooks
  • API docsEndpoint reference, authentication, and examples

What's new

  • Releases open_in_new
  • Articles open_in_new

The latest release is live

Granular audit logs, role-based export controls, and multiple SSO identity providers across the platform.

Read the release notes open_in_new
Products
  • New Home
  • Releases open_in_new
  • Articles open_in_new
  • Community open_in_new
  • Support
Language
  • Spanish (Mexico)
  • Portuguese (Brazil)
  • English (US) check
Login
  1. Home
  2. New Home
  3. Platform
  4. Talent Intelligence Platform
  5. Talent Design
  6. Roles Design
  7. Create roles
close /

No matching articles

Try a product name, or contact support.

homeTalent Intelligence Platform
  • Calibration
    • Talent Design
      • Protocols and standards in Eightfold
      • Match score explanation
      • Introduction to Resume Parser
      • AI-Enabled Skill Proficiency Inference
      • Matching and Calibration
      New Home

      Create roles

      scheduleLast updated on November 13, 2026

      Purpose

      This article provides a general overview and guidelines for creating roles in JIE, and how to enable JIE for your team.

      Audience

      Talent admins, HRBPs

      Overview

      Roles are crucial for designing, building, and maintaining a skill-based workforce within an organization. They are also a key component of the Eightfold platform, which supports various use cases in TA and TM. These use cases include but are not limited to - Position auto calibration, assessments, Career Navigator, Succession Planning, and Upskilling.

      • Users can create roles using multiple methods.
      • Role title and job code are mandatory for all roles. Job code is a unique identifier and cannot be shared between roles.
      • If a role with an existing job code is uploaded or synced via ATS, it will update the existing role (subject to the config under role_update_fields_config in role_library_config).
      • Roles created through auto initialization, file ingestion, or API may remain unapproved until manually approved, based on the config settings.

      How to create roles

      The different methods or channels of creating roles are listed below. These channels also help in keeping the roles updated recurrently.

      Auto Initialization

      Roles can be created automatically from position or employee profile data within a group ID. When a new job code is found in this data, a corresponding role is created. The role's attributes are determined based on positions and employees with the same job code. As new employees or positions are added, new roles are created if needed, as long as role creation is enabled in the settings.

      To know more about this, read Role Initialization for JIE.

      Sync from ATS/HRIS

      Roles can be synced from external ATS or HRIS systems if predefined roles exist. We currently support syncing from SuccessFactors and Workday. Note that roles in Eightfold may correspond to different objects (such as 'Job Profile') in external systems.

      Roles can be synced periodically, similar to Position or Employee syncs. We run daily and weekly syncs for ATS roles.

      To enable role sync, follow these steps:

      1. Go to https://app.eightfold.ai/integrations/ats?tabid=configjson (Admin Console > Integration > Integration Systems) and select the ATS/HRIS.
      2. Select the System ID from the Select System ID dropdown.
      3. Navigate to the Advanced tab. Add 'role' in the 'entities' field under 'sync_settings', and ensure that 'is_enabled' is set to true. Click Compare & Save.
      4. Add the group ID in the role_backfill_ingestion_gate.

      File ingestion

      Eightfold supports one-time file ingestion for roles using CSV, and both one-time and recurring ingestion using XML files. Each role must include a title and job code, and for XML uploads, an external ID is also required.

      To use this feature, you can navigate to Admin Console > Integration > File Ingestion. Eightfold provides you with sample XML and CSV files, along with sample schema within the Download Sample Files and Download Schema options.

      You can upload the roles file, or enter the file path and then click Ingest.

      The external ID, unique to each role from the customer's system, ensures accurate updates. The job code, found under ‘associated_tags’, links roles with employees and positions and must match exactly (including whitespaces and case) for proper linkage. For customers without an external ID system, Eightfold recommends using the job code as the external ID, ensuring uniqueness.

      Include all relevant role attributes when available. Eightfold can advise on the best data integration approach based on your data structure. Providing a sample Excel file with your employee or role data can assist in this process. To know more about recurring ingestion, read JIE recurring file-based roles ingestion.

      Manual role creation

      Eightfold also provides you the ability to create roles manually. To create a role, follow these steps:

      1. Select Talent Design from the ‘waffle’ icon (nine-dot menu) at the top-right corner of your screen.
      2. Click Create New Role.
      3. Enter the relevant details for the role, such as - Role Title, Location(s), Role Tags, Ideal Candidate, Skills, and more.
      4. Click Confirm Role when done.

      Role attributes and properties

      The below table lists all the attributes and tags for a role, serving as metadata that is used by TA and TM to understand the role better.

      Property/Attribute Name Mandatory (M)/Recommended (R)/Optional (O) Description
      Role Name/Title M The title of the role
      External (ATS) Id M This identifier comes from an external ATS/HRIS system where the role is defined or updated, either through file upload or ATS sync. It informs Eightfold that this role is synced from an external system, preventing accidental edits or updates to fields that should be managed externally.
      Tags
      JobCode M The job code is a unique ID for each role and can't be shared with another role. Job codes are crucial for connecting employees or positions to roles.

      Multiple job codes for one role are not supported.

      JobLevel M The job level is an alphanumeric code, chosen from a list of seniority levels set in the Internal Mobility config. It shows where this role sits in the company's hierarchy of seniority. Many companies already use something similar, such as job grade or salary grade, assigning one level to each employee. Each role can only have one job level, and all employees in that role (linked by job code) should have the same level.
      Title O This is an alternative to the Role Name, and can be used in employee facing applications/usecases, such as Career Navigator.
      BusinessFunction R This is sometimes called Job Family or Job Function. Examples: Software Engineering, Field Sales, and more.
      BusinessUnit R This is usually a department or a sub-organization within the company. Examples: Engineering, or Accounting. It is recommended to fill this for a role if the role is specific to that Business Unit.
      Calibration
      Skills and Skill Proficiencies R
      Years of Experience R
      Ideal Candidate(s) R

      Custom tags

      It is possible to create additional tags for roles, in addition to the default tags mentioned in the previous section. These additional tags may help with role management tasks - in searching for, or filtering and sorting roles based on different tag values.

      To create additional tags, follow these steps:

      1. Check if the tag already exists for the group ID using the custom fields dashboard.
      2. If a tag isn’t already available, create a custom field to store the values of the tag in roles, using the Create option.
      3. The fields that are available in roles by default for all group IDs are:
        • efcustom_text_job_family
        • efcustom_text_job_function
        • efcustom_text_job_band
        • efcustom_text_job_code
        • efcustom_text_job_level
        • efcustom_text_business_unit
        • efcustom_text_business_function
        • efcustom_text_title

      Enable JIE

      This section provides an overview about enabling JIE for your organization.

      Map roles to job codes

      If your organization utilizes job codes to uniquely identify roles, Eightfold can seamlessly set up your organizational roles within the role library, ensuring a smooth transition of your role definitions.

      Data preparation

      The first crucial step is to prepare your organizational data for ingestion into the JIE role library.

      1. Role creation: using any of the methods described in the previous sections.
      2. Skill requirement definition for each role: the true value of roles within the Eightfold platform lies in the skill sets attributed to them. As organizational roles are established in the role library, we collaborate to define their respective skill sets. This enables you to leverage these roles effectively across the TA and TM modules.
        1. Integration with ATS/HRIS
        2. Recurring file-based bulk setup: or a bulk setup, a file-based ingestion method similar to the one described earlier can be employed. Eightfold would require an excel spreadsheet containing roles, along with associated skills and proficiencies.
        3. Manual role definition: alternatively, roles can be manually defined or updated within the role library. Users can add skills to roles and grade them based on proficiency using a customizable numeric scale.

      Begin using JIE

      Once roles and employee data are established within the role library, it becomes a centralized repository powering the TA and TM modules. Continuously maintain and update the role library to ensure alignment with organizational needs and evolving talent requirements.

      #use roles #develop positions #methods to create roles

      Was this article helpful?

      thumb_upYes
      thumb_downNo
      rate_reviewGive feedback about this article

      On this page

        No sections

        Related

        Roles Design Understand Roles Design

        Eightfold is the agentic talent intelligence company that gives every HR leader, recruiter, and people manager the intelligence to see, develop, and deploy the full depth of talent around them.

        Talent intelligence, human-led

        Eightfold Platforms

        • Talent Acquisition
        • Talent Management
        • Workforce Exchange
        • Resource Management
        • API Documentation
        • Release Notes

        About Eightfold

        • Blog
        • Careers
        • Contact Us
        • Events
        • Leadership
        • Partners
        • Press
        © Eightfold, 2026. All rights reserved worldwide. Privacy Policy Cookie Notice
        Follow Us :

        Definition by Author

        0
        0
        Expand