Why This Guide Exists
At Craft, CSV uploads are used to support bulk management of people and programs in Craft's OJL Tracker. While the platform allows for one-by-one data entry, CSV uploads streamline the onboarding and setup process, especially for organizations with multiple employers, education providers, or large learner cohorts.
This guide walks through:
- What templates to use
- What order to upload them in
- How Craft uses the data
- Tips for troubleshooting and reducing errors
Recommended Upload Sequence
We strongly recommend completing the setup steps in this order:
- Create Organizations
- Create the Program
-
Add People
- Note: Currently, the Sponsor Admin Role does not support bulk uploading of users.
- Assign Learners to the Program
Each step builds on the last, so uploading out of order can result in validation errors or missing assignments.
Opening the Templates
If you have Microsoft Excel or Apple Numbers installed, you can open our CSV templates directly with those programs.
Don’t have Excel or Numbers? No problem! You can also open the templates in your web browser via Google Sheets. Simply upload the CSV file to your Google Drive. Then, open a new Google Sheet and select “File” > “Import” to load the content into your spreadsheet.
Step 1: Create Organizations
Relevant Support Article: What is a Sponsored Organization?
Bulk Upload Template Name: _templates_organizationtemplate
What This File Does: Creates Organizations (education providers and employers) which live under your Sponsor Organization.
Key Columns
Organization Name: The name of your Organization
Organization Type: Employer or Education Provider
Admin First Name: If you would like to add an Administrator to this organization who is not an Administrator of your Sponsor Org, you can input their first name here.
Admin Last Name: If you would like to add an Administrator to this organization who is not an Administrator of your Sponsor Org, you can input their last name here.
Admin Email Address: If you would like to add an Administrator to this organization who is not an Administrator of your Sponsor Org, you can input their email here.
Formatting Instructions
- First, download the appropriate template. The template for creating organizations can be found by clicking Organizations on the left hand side bar, then + Sponsor an Organization, then Download Template.
- Once you have downloaded and opened the template, begin by typing Your first organization's name into cell A2.
- Write the type of organization (Employer or Education Provider) into cell B2.
- If you have an administrator in mind for this organization that is not an administrator for your sponsor organization (such as an administrator at a partner employer site, or a director at an education provider) you can input their first name in cell C2. Please note, if you do not have this information readily available, you can add this user at a later step. If this is the case, leave cell C2 blank.
- If you do intend on adding an administrator to this new organization, input their last name in cell D2 and email in cell E2.
- Continue to add additional rows outlining the remainder of your organizations.
Step 2: Create the Program
Relevant Support Article: Create Program Content
Bulk Upload Template Name: _templates_programtemplate.csv
What This File Does: This file creates the structural program foundation in Craft's OJL Tracker.
Key Columns
Type: Used to define the structure of your program. (Program > Level > Plan > Activity)
Name: The display name of the Program, Level, Plan, or Activity within the OJL Tracker.
Description: The description for your Program, Level, Plan, Activity.
External ID: A unique identifier from your organization’s system used in CSV uploads to match people, programs, or orgs across Craft and external databases. This can be left blank.
Formatting Instructions
- First, download the appropriate template. The template for creating a program can be found by clicking Programs on the left hand side bar, then + Add Program, then Get Template.
- Once you have downloaded and opened the template, begin by typing PRORAM into cell A2. Write the name of your program in cell B2, and the description of your program in cell C2
- Type LEVEL into cell A3. Write the name of your first level into cell B3, and your description in cell C3.
- Type PLAN in cell A4. Write the name of your first plan in cell B4, and your description in cell C4.
- Type ACTIVITY into cell A5, Write the name of your first activity in cell B5, and your description in cell C5.
- Continue to add additional rows outlining the remainder of your Levels, Plans and Activities.
Tips
- External IDs can be left blank for most users. If you do require External IDs, please contact your CSM.
- Type should always be capitalized (PROGRAM vs Program, ACTIVITY vs activity)
- The name of your program, levels, plans, and activities can be modified in the OJL Tracker once the bulk upload is complete.
- Additionally, if needed, descriptions can also be added retroactively in the OJL Tracker if they are not immediately available during the bulk upload process. If this is the case for you, leave the cells under Description blank.
Step 3: Add People to Craft
Support Article: Sponsor Admin: How to Add and Invite People
Sponsor Admins have the ability to add learners to the OJL Tracker in bulk. If you are interested in adding your learners in bulk, we recommend reaching out to your Customer Success Manager for assistance. To add users one at a time, please follow the steps outlined in the above article.
Step 4: Assign Learners to Programs
Support Article: Education Provider Admin: Assign Learners and Evaluators to Programs
Bulk Upload Template Name: _templates_learnertemplate.csv
What This File Does: Connects existing learners to the correct program.
Key Columns
Learner Email: Must already exist in Craft (from Step 2)
Learner External ID: Can be left blank
Formatting Instructions
- First, obtain the appropriate template. Navigate to your Program. In the upper right corner of your Program, select Assign and then Assign Learners to Program. Select a start and end date for your program, then select Next. Click uploading a CSV file. Then click Get Template.
- Once you have downloaded the appropriate template and opened it, you can begin populating the template. Add the emails of the Learners you wish to assign to your Program under the column Learner Email.
Tips
- Learners must already be added into the OJL Tracker (Step 2).
- Double-check email spelling as miss-typed emails will cause errors.
- External ID can be left blank.
Errors and Fixes
Template Errors
Most errors with CSV uploads are due to the format in which the data is uploaded. Craft has specific templates you must use to upload your data. If your upload does not follow the template, your data will not load into Craft. To obtain your required template, navigate to the appropriate upload page. You will see the option to download the required template next to the option to upload your CSV.
Import Error
If there is an error with your CSV upload, you will see a red banner at the bottom of the page after uploading your CSV. You can remain on this page, correct the error(s) in your CSV, and then select Try Again to re-upload. Or, you can select Later if you wish to re-upload at another time.
You can hover your mouse over the red exclamation point icon to gain insights on what is causing the error.
In this instance, an error is shown because the type column is not populated.
Notes on Collaborative Programs
For programs with multiple EPs or employers, make sure:
- All organizations are created in the system first
- You have all relevant Org IDs, especially if using onboarding templates (Please reach out to your Customer Support Manager for this information)
- People are correctly scoped to each org, or they won’t appear in dropdowns for assigning or inviting
Helpful Tips for Admins
- Save and version each CSV you upload for internal audit or reprocessing
- Always use the latest templates—reach out to Craft Support if in doubt
- If you’re working in a shared org (such as a sponsor organization), coordinate with your CSM on ownership structure and timing
- When in doubt, upload a test row first and verify in Craft's OJL Tracker before bulk uploading
FAQ
Q: Does Craft support any additional file types for bulk uploads?
A: At this time, Craft only supports bulk uploads via CSV.
Q: I’ve followed the steps outlined in this article, but I am still running into trouble. Who do I reach out to?
A: Please reach out to us at support@crafteducation.com and we would be happy to troubleshoot with you.