Roles Import
Overview
The Roles Import (also known as Occupations Import) allows you to create job roles with descriptions, responsibilities, and associated skill requirements in bulk. This is essential for organisations using Learn Amp's Skills features to define competency frameworks and career pathways.
What You Can Do
Create multiple roles/occupations at once
Group roles into categories
Add descriptions and key responsibilities
Associate skills with required proficiency levels
Build competency frameworks at scale
CSV File Format
Required Fields
Field | Description |
|---|---|
| Name of the role/occupation (must be unique) |
Optional Fields
Field | Description |
|---|---|
| Category to group the role under (created if it doesn't exist) |
| Description of the role |
| Key responsibilities for this role |
| Comma-separated skills with optional proficiency levels |
Associating Skills with Roles
Skills can be associated with roles along with required proficiency levels.
Format
Skill Name [Level], Another Skill [Level], Third SkillExamples
Associated Skills Value | Result |
|---|---|
| Communication at level 3, Leadership at level 4 |
| Both skills with no specific level requirement |
| Data Analysis at level 5 |
Skill Levels
Skill levels typically range from 1-5:
Level | Typical Meaning |
|---|---|
1 | Beginner/Awareness |
2 | Basic/Developing |
3 | Intermediate/Competent |
4 | Advanced/Proficient |
5 | Expert/Mastery |
Import Process
Navigate to Settings → Company Settings → Imports → Roles
Click Start Import
Download the template if needed
Upload your CSV file
Review any validation errors
Confirm the import
Pre-requisites
Role Requirements
Only users with the Owner or Admin role can run Roles imports.
Before You Start
Skills must exist – All skills referenced in the CSV must already exist in your Learn Amp account
Unique role names – Each role name must be unique; duplicates will cause errors
Plan your categories – Role Groupings are created automatically if they don't exist
Troubleshooting
Issue | Solution |
|---|---|
"Unable to resolve skill" | The skill name doesn't exist in Learn Amp—create it first or check spelling |
"Unable to resolve skill level" | Skill level must be a valid number (typically 1-5) |
"Role name already exists" | Role names must be unique—use a different name or update the existing role manually |
Skills not appearing on role | Check the exact skill name matches what's in Learn Amp (case-sensitive) |
FAQs
Q: Can I update existing roles via import?
The import will update existing roles if the Role name matches exactly (case-insensitive). New skills and levels will be added.
Q: What if I don't want to set a skill level?
Simply omit the [Level] part—just use the skill name, e.g., Communication, Leadership.
Q: Can I remove skills from a role via import?
No—imports only add or update skills on roles. To remove a skill association, edit the role directly in Learn Amp.
Q: How do I create the skills first?
Use the Skills settings in Learn Amp, or import skills using the Skills Import feature before importing roles.
Q: What's the difference between Role Grouping and Role name?
Role Grouping is a category that contains multiple roles (e.g., "Engineering" might contain "Software Developer", "QA Engineer", "DevOps Engineer"). Role name is the specific occupation.