Items Import with sFTP
Overview
If you have learning content to migrate to Learn Amp, you can use the Items Import to upload content files and metadata in bulk. sFTP is used to transfer content files (SCORM, videos, documents), while the CSV metadata is imported through the Learn Amp interface.
What You Can Do
Upload SCORM, xAPI, and AICC packages
Migrate video content (MP4 and similar formats)
Import documents (PDF, Word, PowerPoint)
Add items to existing Learnlists and Channels
Set metadata like tags, descriptions, and source IDs
Supported Content Types
File Type | Description |
|---|---|
ZIP | SCORM, xAPI, AICC packages |
MP4 | Video content |
PDF, DOCX, PPTX | Downloadable documents |
PNG, JPG | Images and thumbnails |
Two-Step Import Process
Step 1: Upload Content Files via sFTP
Connect to your sFTP server
Upload all content files (SCORM zips, videos, documents, images)
Place files in the root folder—do not use subdirectories
Step 2: Import CSV via Learn Amp
Navigate to Settings → Company Settings → Imports → Items
Click Start Import
Upload your CSV file containing item metadata
Map columns and review any errors
Confirm the import
CSV File Format
Required Fields
Field | Description |
|---|---|
| Name/title of the learning item |
| Content type (see list below) |
Optional Fields
Field | Description |
|---|---|
| Body text for the item page (basic HTML allowed) |
| Identifier for content origin (e.g., old LMS name) |
| Unique ID from source system (useful for activity imports) |
| Comma-separated list of tags |
| Filename for video, audio, or document files |
| Filename for SCORM/xAPI/AICC packages |
| Filename for tile/hero image |
| Public URL for tile/hero image |
| External web link (YouTube, Vimeo, websites) |
| Comma-separated Learnlist names to add item to |
| Comma-separated Channel names to add item to |
| Topics or Skills to associate with the item (see details below) |
|
|
| CPD hours awarded for completion |
Understanding the Skills Column
The Skills column is used for both Topics and Skills, depending on your organisation's configuration:
If you have Learning Taxonomy enabled (without full Skills), use this column for Topics
If you have the Skills feature enabled, use this column for Skills
Format: Enter names as a comma-separated list. Skill levels in brackets are optional.
What you want to add | Example |
|---|---|
Topics only (no skill levels) |
|
Skills with proficiency levels |
|
Mixed (some with levels, some without) |
|
💡 Tip: If you just want to add Topics without skill levels, simply list the topic names separated by commas — you do NOT need to include any
[level]brackets.
Supported Item Types
article, document, book, video, elearning, audio, slides, image, classroom, coaching, course, event, webinar, action, website, other
File Naming Rules
File names in your CSV must exactly match the files uploaded to sFTP
Use consistent naming without special characters
Do not use subdirectories—all files must be in the sFTP root folder
Adding Items to Learnlists and Channels
To add items to Learnlists or Channels during import:
Create the Learnlists/Channels first (via their respective imports)
In your Items CSV, include the exact Learnlist or Channel names
Items will be added to matching Learnlists/Channels during processing
💡 Tip: The Learnlist/Channel must already exist—new ones won't be created.
Known Limitations
Limitation | Details |
|---|---|
Cannot schedule | Items imports are run manually via the Learn Amp interface |
Content must exist first | When adding to Learnlists/Channels, those must already exist |
No nested folders | Upload all files directly to the sFTP root folder |
One package per ZIP | Each ZIP file must contain exactly one SCORM/xAPI package |
Pre-requisites
Role Requirements
Only users with the Owner role can run Items imports.
Before You Start
sFTP must be enabled and configured
Content files must be uploaded to sFTP before importing the CSV
Learnlists/Channels must exist if you want to add items to them
FAQs
Q: Do I need sFTP to import items?
sFTP is required for uploading content files (SCORM, videos, documents). For items that are just web links, you can import via CSV without sFTP.
Q: Can I update existing items?
Yes—use the Items Update import to modify metadata for existing items.
Q: What if my SCORM package fails to upload?
Ensure the ZIP contains a valid, single SCORM package with the correct manifest file. Check the import log for specific error messages.
Q: How do I add items to multiple Learnlists?
Use a comma-separated list of Learnlist names in the Learnlists column.
Q: Why is the column called "Skills" when I want to add Topics?
In Learn Amp, Skills and Topics share the same underlying system. The column is labeled "Skills" but works for Topics too. If your organisation only uses Learning Taxonomy (not full Skills), just enter your topic names in this column.
Q: Do I have to add skill levels in the Skills column?
No. Skill levels are optional. You can enter just the topic/skill names separated by commas (e.g., Leadership, Communication, Coaching) without any brackets or level numbers.