Managing Library Content via the Library Content Update Importer
This article explains how to manage learning content that has been pushed into your account from a Library using the Library Content Update (new importer). You'll learn how to:
Adjust topic and skill levels
Export and re-import content updates via CSV
🛠️ Editing Permissions for Library Content
You can only edit topics and skill levels for content pushed from a Library account.
🔒 You cannot edit:
Title
Description
Core content (e.g., videos, documents, etc.)
These fields are managed by the content's source account.
🧠 Managing Topics and Skill Levels
If your account has a learning taxonomy and a skill rating scale, you can manage the topics and skill levels of any pushed content.
To update topics and skill levels manually (not yet released):
Click the 3-dot menu on the item.
Select Update topic and skill level.
You can:
Add or remove topics that already exist in your account.
Assign skill levels using your account's rating scale.
📝 Note: These updates apply only in your account. They do not affect the source content.
📤 Exporting Pushed Content
You can export a list of all items pushed into your account from a Library or Parent account using the Library Content Update tool.
The CSV export includes:
Field | Notes |
|---|---|
| Do not edit |
| Do not edit |
| Reference only |
| Editable — see format details below |
📥 Importing Updates via CSV
You can use the Library/Parent Content Update Importer to update items in bulk. The tool matches content based on:
item_iditem title
What can you update?
Add topics/skills — Enter topic or skill names as a comma-separated list
Assign skill levels (optional) — Add a numeric value in square brackets after each skill
Understanding the skills [level] Column
The column is named skills [level] but skill levels are optional. You can add topics without specifying any skill level.
📝 Examples:
Use Case | Format |
|---|---|
Topics only (no skill levels) |
|
Topics with skill levels |
|
Mixed (some with levels, some without) |
|
💡 Tip: If your organisation doesn't use skill levels (only Topics in your Learning Taxonomy), simply enter your topic names separated by commas — you do NOT need to include the
[level]brackets.
🔒 The item title and library_source fields are read-only — updating them in the CSV will have no effect.
➕ Adding Topics via Import
When importing updates:
Existing topics are retained.
Any new topics in the CSV are added.
📝 Example:
If an item has topics T1 and T2, and the CSV includes T1 and T3, the final result will be:
→ T1, T2, T3
🧹 Optional: Remove Existing Topics and Skill Levels
You can enable an optional setting:
"Remove topics and skill levels"
When enabled:
Any topic or skill not listed in the CSV is removed.
If the topic cell is blank, all topics and skill levels are removed from the item.
Examples:
Current Item Data | CSV Input | Result |
|---|---|---|
Topic 1, Topic 2 | Topic 1 | Topic 2 is removed |
Topic 1 [Skill level 1] | Topic 1 | Skill level 1 is removed from Topic 1 |
Topic 1 [Skill level 1], Topic 2 [Skill level 2] | (Blank) | All topics and skill levels removed |
❌ Error Handling
The importer will reject your CSV if:
The
item_idoritem titledoes not match an existing item in your account.A topic in the CSV doesn't exist in your account's taxonomy (unless you're using the removal setting and leaving the cell blank).
👤 If the Uploading User is Deleted
If the user who uploaded a CSV is later deleted:
The changes made by the import remain intact.
The CSV entry remains visible in the import log for reference.
💡 Top Tips
🔹 Do not edit the
library_sourcecolumn.
It is for reference only and does not impact the import process.
📌 Summary of Actions
Task | Manual Option | CSV Import | Notes |
|---|---|---|---|
Edit visibility | ✅ | ❌ | Manual only |
Add/remove skills | ❌ | ✅ | Use rating scale |
Add topics | ❌ | ✅ | Topics must exist in taxonomy |
Remove topics/skills | ❌ | ✅ (with setting) | Only via import |
Change title or description | ❌ | ❌ | Controlled by source |
❓FAQs
Can I overwrite the title of a pushed item?
No, titles are controlled by the source Library or Parent account.
What if my CSV includes a topic that doesn't exist?
The import will fail unless you're using the removal setting and leaving the cell blank.
Can I re-import a corrected CSV after an error?
Yes. Fix the errors and re-upload. Only valid rows will be processed.
How can I check what changes were made?
Use the import log to review uploaded files and their status.
Do I have to include skill levels in the skills [level] column?
No. Skill levels are optional. You can enter just the topic/skill names (e.g., Leadership, Communication, Coaching) without any brackets or level numbers.
🛠️ Troubleshooting
Issue | Possible Cause | Suggested Fix |
|---|---|---|
CSV rejected | Item ID or title doesn't match | Double-check spelling and IDs |
Topics not added | Topic name doesn't exist in taxonomy | Add the topic manually first |
Skill level not applying | Format is incorrect | Use correct format: |
All topics/skills removed unexpectedly | Topic cell left blank + removal setting on | Add topics to the cell or disable setting |