Admin: Starting a Teachable Import Job
Admin: Starting a Teachable Import Job
Version 1.0.59 introduces a guided UI for admins to connect to a Teachable school, select courses for migration, and launch the full import pipeline — all from within the platform.
Overview
The Import Job Initiation UI is a three-step wizard that walks an admin through:
- Entering Teachable school credentials
- Selecting courses to import from the discovered catalog
- Confirming and launching the import pipeline
No manual API calls or direct database access are required.
Prerequisites
- You must have admin-level access to your platform organisation.
- You need valid login credentials (email and password) for the target Teachable school.
- The Teachable school must be accessible over the public internet.
Step 1 — Connect to Your Teachable School
Navigate to Admin → Imports → New Import and complete the connection form:
| Field | Description |
|---|---|
| School URL | The full URL of your Teachable school (e.g. https://yourschool.teachable.com) |
| The email address used to log in to the Teachable school | |
| Password | The corresponding Teachable account password |
Click Connect to proceed. The platform will authenticate against the Teachable school and run the catalog discovery step in the background.
Note: Credentials are used only to authenticate the import request. They are not stored after the catalog discovery step completes.
Step 2 — Select Courses
Once catalog discovery completes, a course selection screen is displayed listing all courses available in the connected Teachable school.
- Select one or more courses to include in the import.
- Course names, descriptions, and other catalog metadata are shown to help you identify the correct content.
Click Continue once you have made your selection.
Step 3 — Confirm and Launch
A confirmation screen summarises your selected courses before any content is migrated. Review the list carefully.
- Click Launch Import to start the full import pipeline.
- The platform will begin extracting course structures, lesson pages, text content, embedded video links, images, and document attachments from the selected courses.
- You will be redirected to the import job status view where you can monitor progress.
What Gets Imported
The import pipeline faithfully reconstructs the following content inside the platform:
- Course structure (sections and lessons)
- Lesson page content (text and rich content blocks)
- Embedded video links
- Images
- Document attachments
Troubleshooting
| Symptom | Likely Cause | Resolution |
|---|---|---|
| "Failed to connect" on Step 1 | Incorrect credentials or school URL | Double-check the URL format and login details |
| Empty course list on Step 2 | Account has no published courses, or insufficient permissions | Ensure the Teachable account has admin or owner access |
| Import job does not start | Network error during confirmation | Retry from the Imports dashboard |