Managing Library Content via the Library Content Update Importer

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):

  1. Click the 3-dot menu on the item.

  2. Select Update topic and skill level.

  3. 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

Field

Notes

item_id

Do not edit

item title

Do not edit

library_source

Reference only

skills [level]

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_id

  • item 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

Use Case

Format

Topics only (no skill levels)

Leadership, Communication, Coaching

Topics with skill levels

Leadership [3], Communication [2], Coaching

Mixed (some with levels, some without)

Agile [5], Project Management, UX Design [2]

💡 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

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_id or item title does 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_source column.
    It is for reference only and does not impact the import process.


📌 Summary of Actions

Task

Manual Option

CSV Import

Notes

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

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: Skill [5] — but remember levels are optional

All topics/skills removed unexpectedly

Topic cell left blank + removal setting on

Add topics to the cell or disable setting