Skip to main content

Lesson Video

Lesson Video​

Embeds the video set in the current lesson's LifterLMS Featured Video field. The widget reads the URL from the lesson being viewed, picks the right player for it (YouTube, Vimeo, self-hosted file or any WordPress-embeddable link), and applies the size and playback options you set here.

Lesson Video widget rendered as an embedded player on a lesson page

Usage​

Lesson template — Place it above the Lesson Content widget in a lesson template so every lesson with a featured video gets a player without per-lesson setup; see How to Build a Lesson Template. Lessons with no featured video render nothing, so the layout stays clean.

Fixed-size player — Turn Dimension auto off and set a Width and Video ratio when the video must not stretch to its container, for example beside a sidebar or inside a card.

Drip-scheduled lessons — Put a message in Content To Show (it accepts dynamic tags, so you can include a Lesson Drip Countdown) and the widget shows that instead of the video until the lesson's drip date passes.

Video-gated completion — If the LifterLMS Advanced Videos add-on requires students to watch the video before completing the lesson, it disables the Mark Complete button until the video ends. The Mark Complete Lesson widget keeps the fixed CSS ID llms_mark_complete the add-on targets, so the two widgets work together without extra setup.

How it works​

SituationBehaviour
Lesson has a featured videoThe URL is embedded with the options below. YouTube, Vimeo and self-hosted files get the full option set; any other URL WordPress can embed (Wistia, Loom and so on) renders through WordPress's own embed and only the width and height apply.
Lesson has no featured video, or the URL is not validNothing is rendered on the front end. In the Elementor editor a placeholder YouTube video and a preview notice appear instead so you can style the widget.
Lesson drip date is in the futureThe Content To Show text renders instead of the video. Users who can bypass LifterLMS restrictions (administrators, and anyone with unrestricted preview access) always see the video.
LifterLMS Advanced Videos add-on is active and recognises the URLThe add-on's player and settings are used instead of the widget's own options, unless you switch Prioritize the options set in the advanced video plugin off.

Settings​

Content — Dimensions

SettingDescription
Dimension autoYes (default) lets the player fill the width of its container. No renders it at the fixed size set by Width and Video ratio.
Video ratioAspect ratio used to work out the height from the width: Classic Film 3:2, Standard, Monitor 4:3, HD Video 16:9 (default) or Cinemascope 21:9. Shown only when Dimension auto is No.
WidthPlayer width in pixels (default 640). Shown only when Dimension auto is No.

Content — Lesson Drip Restriction

SettingDescription
Content To ShowRich text rendered in place of the video while the lesson is drip-locked. Supports dynamic tags and shortcodes. Default: Lesson content is restricted by Drip time in future.

Content — Options

The section notes that these options apply only to YouTube, Vimeo and self-hosted videos, and that Vimeo needs a Plus account or higher before its player controls can be hidden.

SettingDescription
Prioritize the options set in the advanced video pluginYes (default) lets the LifterLMS Advanced Videos add-on's settings override the three options below; No uses the widget's options instead. Shown only when the add-on is active.
Enable controlsYes (default) shows the player's controls. No hides them and adds the le-video-no-controls class to the widget wrapper.
Mute audioYes (default) starts the video muted.
Enable autoplayYes (default) starts playback when the page loads. Browsers generally block autoplay with sound until the visitor has interacted with the page, so keep Mute audio on when relying on autoplay.

Style

The widget has no Style tab; use the Advanced tab for spacing, background and custom CSS.

Advanced

The Advanced tab holds Elementor's own layout, motion, responsive and custom-CSS controls — see Elementor's documentation. Lifter Elements adds one section, Conditional Logic, which shows or hides this widget by the visitor's LifterLMS status — see the Conditional Logic reference.

Notes​