Skip to lesson content

Add video and configure playback

Last updated: September 8, 2026 · 1 min read

Place a video file on the page and configure its poster and controls.

A video-file block differs from embedding a service such as YouTube. Use the Embed lesson for external services.

Follow these steps

  1. 1

    Insert the video

    EditorFiles

    Use video insertion from Files, or Properties > Video on an empty video block. Upload from your computer or select an existing video and wait for completion.

  2. 2

    Set playback

    PropertiesPlayback

    Set autoplay, loop, mute, and control visibility. Browsers may block audible autoplay, so leave a way for the reader to start playback.

  3. 3

    Choose a poster

    PropertiesCover

    Upload or select a poster image. Removing the poster does not remove the video. It controls what appears before playback, not the frames inside the video.

  4. 4

    Prepare accessible content

    PropertiesAccessibility

    Complete the video name, audio mode, transcript, captions, and visual description as appropriate. Follow the Video accessibility lesson for details. Recheck old text and tracks after replacing the source.

  5. 5

    Test reader playback

    EditorPreview

    Try playback, pause, volume, and looping. After resizing the page block, check that the poster and controls fit.

Check your result

Check the result in preview, then verify the reader experience in the published version.