Uploading Skills by CSV
If you already have skills written down, you can import them, or update existing ones, with a CSV file. This is available to admins on the Business or Organisation plan (or during a trial).
Import or update skills
In the left-hand menu, click Position Skills.
Open the Import / Export skills menu and choose Import / Export skills.
To update existing skills, click Download CSV of your N skills and edit that file. To add new skills, you can start from the sample CSV linked on the page.
Click Select a CSV to upload and choose your file.
Check the Import Preview. It lists new skills, matched skills, any skills that will be deleted and any rows that will be skipped.
Click Begin import! to confirm, or Try another file to start again.
Preparing your file
Skill name is the only required column.
Keep the ID the same for skills you're updating. Without an ID, a new skill is created, even if the name matches.
Existing skills you leave out are ignored. Ones you include but don't change are skipped.
The Author and Tags columns are for reference only and don't update.
Formatting such as bold, italics and links is stored as HTML tags (like <b>). See Formatting with HTML below.
Put each example on its own line within the cell (Ctrl + Enter on Windows, Cmd + Enter on Mac in Google Sheets), or they'll merge together.
Save the file as UTF-8 so all characters display correctly.
If the file is formatted incorrectly, you'll see the issues before anything is imported. If it's formatted correctly, it will be imported as it is, so check your content first.
Watch out
Typing delete in the Tags column of a row with an ID permanently deletes that skill. The preview shows "Skill will be deleted" so you can check before confirming.
Formatting with HTML
In the CSV, formatting is stored as HTML tags. You can use these tags in descriptions, levels and examples:
Tag | Use it for |
|---|---|
<p> | Paragraphs |
<strong>, <b> | Bold |
<em> | Italic |
<u>, <s> | Underline, strikethrough |
<ul>, <ol>, <li> | Bulleted and numbered lists |
<h3> | A small heading |
<a href="…"> | Links (http, https or mailto) |
<blockquote>, <code> | Quotes and code |
Good to know
Other tags, styles and attributes are removed when the skill is saved.
After importing
Imported skills are added to your organisation's skill list, not to teams. Open each team to add the skills to categories and positions. You can't export or import a whole framework with positions.
Need skill usage figures instead? Choose Export skill usage data from the same menu.
