Bulk Import of Tasks
Overview
Bulk Import allows you to create multiple tasks at once using a CSV file. This is ideal for:
Migrating task data from another system
Creating large volumes of individual task assignments
Setting up historical task records with completion data
Batch-assigning training to specific users with custom deadlines
Instead of manually creating each task one by one, you can prepare your data in a spreadsheet and upload it in a single operation.
Functionality Breakdown
The Bulk Import of Tasks feature allows you to:
Create individual tasks for multiple users at once
Specify custom deadlines for each assignment
Import completed task data (including completion dates)
Configure recurrence settings per task
Set mandatory/optional status
Control notification behaviour
Assign different content to different users in the same import
Pre-requisites
Feature Requirements
Bulk Import feature must be enabled for your company
You must have Owner or Admin role
Data Requirements
Before importing tasks, ensure:
Content exists: All Items, Learnlists, Quizzes, or other content must already exist in Learn Amp
Users exist: All users referenced by email must be active in the platform
Assigners exist: The assigning users must be valid platform users
Quick Start Guide
Step 1: Access Bulk Import
Navigate to Manage in the sidebar
Select Imports
Click Tasks from the import options
Step 2: Download the Template
Click Download Template to get the CSV format
Open the template in your preferred spreadsheet application
Step 3: Prepare Your Data
Fill in the template with your task data. Required and optional fields are detailed below.
Step 4: Upload and Validate
Click Upload CSV
Select your prepared file
The system will validate your data and show any errors
Review the validation results before proceeding
Step 5: Complete Import
If validation passes, click Import
The system will create all tasks
Review the import summary for any issues
CSV Fields Reference
Required Fields
Field Name | Description | Example |
|---|---|---|
Email address of the user receiving the task |
| |
Assigner | Email of the user setting the task |
|
Content Type | Type of content being assigned |
|
Content Title | Exact title of the content |
|
Set From Date | Date the task becomes active |
|
Deadline Date | Due date for task completion |
|
⚠️ Note: To create an open-ended task (no deadline) via bulk import, leave the Deadline Date field empty. The task will be created without a due date—learners must still complete it, but it will never appear as overdue.
Optional Fields
Field Name | Description | Default |
|---|---|---|
Mandatory | Whether the task is mandatory |
|
Require Completing Again | Invalidate previous completions |
|
Skip New Task Notifications | Don't send new task email |
|
Recurs | Enable task recurrence |
|
Recurrence Months | Months between recurrences (if Recurs = TRUE) |
|
Reopen Before Deadline Days | Days before deadline to re-issue (if Recurs = TRUE) |
|
Completed At | Date task was completed (for historical imports) |
|
Started At | Date task was started (for historical imports) |
|
Field Details
Content Type and Title
The content must already exist in Learn Amp. Use the exact title as it appears in the platform.
Supported content types:
Item- Learning items (videos, documents, articles, etc.)Learnlist- Learning pathwaysQuiz- AssessmentsEvent- EventsSurvey- Surveys
Date Formats
Dates should be in one of these formats:
YYYY-MM-DD(e.g.,2025-01-15)DD/MM/YYYY(e.g.,15/01/2025)
Boolean Fields
Boolean fields accept:
TRUE,true,1,yes,Yes- for enabledFALSE,false,0,no,No- for disabled
Recurrence Settings
If Recurs is set to TRUE, you should also provide:
Recurrence Months: How many months between task cycles
Reopen Before Deadline Days: How many days before the deadline to issue the next recurrence
⚠️ Note: Recurrence requires a deadline. If you leave the Deadline Date empty (creating an open-ended task), the Recurs field will be ignored.
Example CSV
Tasks with Deadlines
Email,Assigner,Content Type,Content Title,Set From Date,Deadline Date,Mandatory,Require Completing Again,Skip New Task Notifications
john.smith@company.com,admin@company.com,Item,GDPR Training,2025-01-15,2025-02-15,TRUE,FALSE,FALSE
jane.doe@company.com,admin@company.com,Item,GDPR Training,2025-01-15,2025-02-15,TRUE,FALSE,FALSE
bob.wilson@company.com,admin@company.com,Learnlist,Onboarding Pathway,2025-01-20,2025-03-20,FALSE,FALSE,TRUEOpen-Ended Tasks (No Deadline)
Email,Assigner,Content Type,Content Title,Set From Date,Deadline Date,Mandatory,Require Completing Again,Skip New Task Notifications
alice.jones@company.com,admin@company.com,Item,Recommended Reading,2025-01-15,,FALSE,FALSE,FALSE
tom.brown@company.com,admin@company.com,Learnlist,Self-Paced Development,2025-01-20,,FALSE,FALSE,TRUE💡 Tip: Leave the Deadline Date column empty to create open-ended tasks. These tasks will display "No deadline" to learners and will never appear as overdue.
Importing Historical Completed Tasks
You can import tasks that have already been completed by including the Completed At field:
Email,Assigner,Content Type,Content Title,Set From Date,Deadline Date,Completed At
john.smith@company.com,admin@company.com,Item,Safety Training,2024-06-01,2024-06-30,2024-06-25This is useful for:
Migrating from another LMS
Recording historical training completions
Maintaining compliance records
💡 Tip: When importing completed tasks, the system will link them to any existing activity records for that user/content combination.
Validation and Error Handling
Common Validation Errors
Error | Cause | Solution |
|---|---|---|
User not found | Email doesn't match any platform user | Verify the email address is correct and the user exists |
Content not found | Content title doesn't match | Check the exact title in Learn Amp |
Invalid date format | Date format not recognised | Use YYYY-MM-DD or DD/MM/YYYY |
Assigner not found | Assigner email is invalid | Ensure the assigner is an active user |
Missing required field | A required column is empty | Fill in all required fields (note: Deadline Date can be empty for open-ended tasks) |
Error File
If errors occur during validation, you can download an error file that shows:
Which rows failed
The specific error for each row
The original data for correction
FAQs
Q: Can I import tasks for users who haven't accepted their invite yet?
Tasks for pending users will be created but marked as 'deactivated'. They'll become active once the user accepts their invitation.
Q: What happens if the content is archived?
The import will fail for rows referencing archived content. Ensure all content is active before importing.
Q: Can I update existing tasks via import?
No. The bulk import creates new tasks only. To update existing tasks, use the Task Log interface.
Q: Is there a limit to how many tasks I can import?
Large imports are processed in batches. There's no strict limit, but very large files (10,000+ rows) may take longer to process.
Q: Will imported tasks trigger email notifications?
By default, yes. To suppress notifications, set Skip New Task Notifications to TRUE.
Q: Can I import recurring tasks?
Yes. Set Recurs to TRUE and provide the Recurrence Months and Reopen Before Deadline Days values. Note that recurring tasks require a deadline—they cannot be combined with open-ended tasks.
Q: Can I import open-ended tasks via bulk import?
Yes. Leave the Deadline Date field empty in your CSV to create open-ended tasks. These tasks will be assigned without a due date and will display "No deadline" to learners.
Q: Can I import a mix of deadline-based and open-ended tasks in the same CSV?
Yes. Simply include a Deadline Date for tasks that need one, and leave it empty for tasks you want to be open-ended. Both types can coexist in the same import file.
Troubleshooting
Issue | Solution |
|---|---|
Import stuck on processing | Large files take time. Wait or try with a smaller batch. |
Some rows imported, others failed | Download the error file to see which rows failed and why. |
Tasks created but not visible | Check the 'Set From Date' – tasks may be scheduled for the future. |
Completed tasks showing as incomplete | Ensure the Completed At date is in the correct format. |
Wrong content assigned | Verify the Content Title exactly matches the content name in Learn Amp. |
Open-ended tasks showing a deadline | Ensure the Deadline Date column is truly empty (no spaces or placeholder values). |