Video
Video
Renders the featured video for the current LearnDash lesson or topic, with configurable aspect ratio and an optional featured image fallback.
Usage
On a lesson or topic Themer template — Place at the top of the content area. The module renders the video URL stored in the LearnDash lesson/topic settings automatically.
With featured image fallback — Enable Fallback to featured image to show the lesson's featured image when no video is set. This prevents an empty space on lessons that don't have a video, keeping the layout consistent across mixed-content courses.
Blocking content until video is watched — Enable Show message if progression is incomplete to display a message in place of (or alongside) the content when video progression is active and the learner hasn't watched the video yet. Use the Default message type to show LearnDash's built-in message, or Custom to write your own.
How it works
The video is pulled from the LearnDash video URL field on the lesson or topic. If Fallback to featured image is off and no video URL is set, the module renders nothing.
When video progression is active on the lesson, LearnDash locks the mark complete button until the video has played. This module's Show message if progression is incomplete setting gives you a way to surface that gate to the learner.
Settings
General
| Setting | Description | Default |
|---|---|---|
| Show message if progression is incomplete | Show a message when video progression is active and the video hasn't been watched. | Off |
| Message type | Use LearnDash's Default message or write a Custom one. (Visible when message is enabled) | Custom |
| Custom message | The message text to display. (Visible when Custom message type is selected) | — |
| Aspect ratio | Video aspect ratio: 16:9, 1:1, 4:3, 3:2, 8:5, or Custom (set width and height manually). | 16:9 |
| Fallback to featured image | Show the featured image when no video URL is set. Enabling this reveals the Image tab. | Off |
| Hide controls | Hide the video player controls. | Off |
Style
| Setting | Description | Default |
|---|---|---|
| Alignment | Horizontal alignment of the video (responsive). | — |
| Width | Video width with unit (px, vw, or %). | 100% |
| Border | Border style, width, and radius around the video (responsive). | — |
Image (visible when Fallback to featured image is enabled)
| Setting | Description |
|---|---|
| Crop | Image crop style: none, landscape, panorama, portrait, square, or circle. |
| Width | Image width with unit. |
| Border | Border style and radius for the fallback image (responsive). |