All Docs
FeaturesCSI Teachable Replacement AppUpdated March 13, 2026

Video URL Embedding in Lessons

Video URL Embedding in Lessons

Instructors can embed videos from YouTube, Vimeo, Wistia, and Loom directly inside a lesson by pasting a standard share or watch URL into the lesson editor's video field. The platform handles URL validation and the conversion to an embeddable format automatically.

Supported Providers

ProviderAccepted URL Format
YouTubehttps://www.youtube.com/watch?v=<id> or https://youtu.be/<id>
Vimeohttps://vimeo.com/<id>
WistiaShare or media URL containing the video ID
Loomhttps://www.loom.com/share/<id>

Adding a Video to a Lesson

  1. Open the lesson editor for the lesson you want to update.
  2. Locate the Video field in the lesson settings panel.
  3. Paste your video URL (copied directly from the provider's share or address bar) into the field.
  4. The field validates the URL in real time:
    • If the URL is valid and supported, it is accepted and a preview confirmation is shown.
    • If the URL is invalid or from an unsupported provider, an error message is displayed and the lesson cannot be saved until the URL is corrected or removed.
  5. Save the lesson. The video is now available to learners.

How Embed Transformation Works

When a URL is saved, the platform rewrites it into the provider's standard embed format before storing it. This means instructors never need to manually construct an embed URL or locate a special embed link.

Example — YouTube:

# Pasted by instructor
https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Stored and rendered as
https://www.youtube.com/embed/dQw4w9WgXcQ

Example — Vimeo:

# Pasted by instructor
https://vimeo.com/123456789

# Stored and rendered as
https://player.vimeo.com/video/123456789

Example — Loom:

# Pasted by instructor
https://www.loom.com/share/abc123def456

# Stored and rendered as
https://www.loom.com/embed/abc123def456

Learner View

Learners see the video rendered as a responsive iframe embedded directly within the lesson page. No additional plugins or browser extensions are required. The iframe is sized to fit the lesson content area.

URL Validation Rules

  • The URL must be a well-formed https:// link.
  • The URL must match one of the four supported provider patterns (YouTube, Vimeo, Wistia, Loom).
  • URLs from unsupported providers (e.g. Kaltura, Brightcove, direct MP4 links) will fail validation. Use the file upload option for self-hosted video files.
  • Only one video URL can be set per lesson at a time. Saving a new URL overwrites the previous one.

Relationship to Teachable Import

When courses are imported from Teachable, any video URLs already embedded in lesson content are detected, validated, and stored using the same provider transformation pipeline — ensuring imported video lessons render correctly without manual intervention after import.