Media
Add images, audio, video, YouTube embeds, and social media content to lessons.
Rich media makes language lessons engaging and memorable. The Lex Editor supports images, audio files, YouTube videos, Twitter embeds, and file attachments -- all inserted directly into your lesson content.
Images
Uploading Images
Open the Image Insert
Click the Insert Image button in the toolbar, or type /image in the editor.
Choose a Source
- Upload: select an image file from your computer (JPEG, PNG, WebP, GIF)
- URL: paste a URL to an image hosted elsewhere
- Library: choose from previously uploaded images
Configure the Image
- Alt text: describe the image for accessibility (always recommended)
- Caption: optional text displayed below the image
- Size: small, medium, large, or full width
Insert
Click Insert to place the image at the cursor position.
Resizing and Alignment
After inserting an image, click it to select it. You will see:
- Corner handles -- drag to resize proportionally
- Alignment buttons -- left, center, or right alignment
- Replace -- swap the image for a different one
- Link -- make the image clickable
Keep image file sizes under 2 MB for best performance. Large images slow down lesson loading, especially for students on mobile networks.
Inline Images
For smaller images that need to sit alongside text (such as icons, flags, or small vocabulary pictures), use the inline image option. Inline images flow within the text line rather than taking up a full block.
Type /inlineimage or use the Insert menu to add an inline image.
Audio
Inserting Audio Files
Open Audio Insert
Click Insert Audio in the toolbar or type /audio.
Choose Method
- Upload: select an audio file (MP3, WAV, M4A, WebM)
- Record: record audio directly in the browser using your microphone
- URL: link to an externally hosted audio file
Configure
- Title: a name for the audio clip (e.g., "Dialogue at the Airport")
- Transcript: add a text transcript (recommended for accessibility)
- Transcript visibility: hidden, shown after listening, or always visible
Insert
The audio player block appears in the lesson.
Audio Player Features
The audio player displayed to students includes:
- Play/pause button
- Progress bar with scrubbing
- Volume control
- Playback speed adjustment (0.5x, 0.75x, 1x, 1.25x, 1.5x)
- Download option (if enabled)
- Transcript toggle (if transcript was provided)
For listening comprehension exercises, set the transcript to "after-listen" mode. Students will not see the text until they have listened at least once, encouraging genuine listening practice.
YouTube Videos
Embedding YouTube
Open the Embed
Type /youtube or click the video button in the toolbar.
Paste the URL
Paste a full YouTube URL (e.g., https://www.youtube.com/watch?v=...) or a shortened youtu.be link.
Configure
- Size: choose the display size
- Start time: optionally start the video at a specific timestamp
Insert
The YouTube player appears embedded directly in the lesson.
Students can watch the video without leaving the lesson page. Controls are handled by the standard YouTube player.
Twitter / Social Media Embeds
You can embed tweets and social media posts directly into lessons. This is useful for:
- Showing authentic language use in social media
- Discussing cultural content
- Analyzing informal or colloquial language
Type /twitter or paste a tweet URL. The editor will detect and embed it automatically.
Auto-Embed Detection
The editor has an auto-embed system that detects URLs for supported services. When you paste a URL on its own line, the editor automatically offers to convert it into a rich embed for:
- YouTube videos
- Twitter/X posts
- Other supported platforms
Frequently Asked Questions
What image formats are supported?
JPEG, PNG, WebP, and GIF are supported. WebP is recommended for the best balance of quality and file size.
Is there a file size limit for uploads?
Images should be kept under 2 MB for optimal performance. Audio files can be larger, but we recommend compressing them when possible.
Can I record audio directly in the editor?
Yes. The audio upload dialog includes a recording option that uses your browser microphone. Grant microphone permission when prompted.
Can I embed Vimeo or other video platforms?
Currently, YouTube is the primary supported video platform. For other services, you can link to the video URL, but rich embedding is not guaranteed.


