Articles on: The editor

Video

The Video element plays a video on your page. The video can come from three sources:


  • a YouTube or Vimeo link
  • a link to a hosted video file that ends in .mp4 or .webm
  • a video uploaded to the media library


You add the Video element from the Add panel on the left side of the editor, and you set it up in the Video settings in the right panel.



To add a YouTube or Vimeo video to your page:


  1. In the editor, open Add on the left side.
  2. Add the Video element to your canvas.
  3. With the video element selected, find the Video settings in the right panel.
  4. Paste the YouTube or Vimeo link into the Paste a video link field.


The Paste a video link field also accepts the embed code from YouTube's or Vimeo's share dialog, and a YouTube or Vimeo link without https://. To add a hosted video file instead, paste a link that starts with http:// or https:// and ends in .mp4 or .webm.


If the video element doesn't recognize the link, the field turns red with the message "Use a YouTube or Vimeo link, or a link ending in .mp4 or .webm", and the link is not saved.


Adding a video from the media library


To add a video file that you upload yourself:


  1. Add the Video element from the Add panel on the left side of the editor, and keep it selected.
  2. In the Video settings, click Select from library.
  3. In the media library, select the video. To use a new video file, upload it there first, then select it.


The media library accepts MP4, WebM and Ogg video files of up to 100 MB. For the requirements and recommendations, see Uploaded video files.


YouTube and Vimeo privacy settings


A YouTube or Vimeo video only plays on your page when its privacy settings allow it to be embedded. If they don't, the video element can't load the thumbnail and visitors can't play the video.


YouTube


A YouTube video must be set to Public or Unlisted to play on your page. A private YouTube video can't be shown. For the options, see YouTube's privacy settings.


Vimeo


A Vimeo video must be public, or unlisted with embedding allowed. For an unlisted Vimeo video, use these settings in Vimeo's privacy panel:


  • Who can watch?: Unlisted
  • Where can this be embedded?: Anywhere


Image: embed options in Vimeo


Which privacy options you can use depends on your Vimeo plan. For the options, see Vimeo's privacy settings.


Uploaded video files


A video file uploaded to the media library for the Video element can be up to 100 MB, in MP4, WebM or Ogg format.


  • Recommended format: MP4, because it plays in the widest range of browsers.
  • File size: smaller files load faster on the published page. To make a video file smaller, see Reducing video file size.
  • Subtitles: you can add a subtitle file to an uploaded video. In the Video settings, click the video's source row, then use Select a file under Subtitles. Use a WebVTT (.vtt) file, the format browsers expect for subtitles.


Changing the video thumbnail


A YouTube or Vimeo video uses the thumbnail from YouTube or Vimeo by default. An uploaded video uses a frame from the video. To change the thumbnail of a video element:


  1. Select the video element.
  2. In the Video settings, click the video's source row. It is named YouTube, Vimeo, Library or Link.
  3. Choose one of these:
    • Click Refresh thumbnail to load the current thumbnail from YouTube or Vimeo, for example after you changed it there.
    • Click Poster under Thumbnail and choose your own image.


The thumbnail is shown before the video starts playing. Refresh thumbnail is only available for YouTube and Vimeo videos.


Setting a custom play button


A custom play button replaces the default play icon on a video with an image you choose. To set one:


  1. Select the video element.
  2. In the Video settings, under Playback, click the sliders button next to Controls.
  3. Click Play button and choose an image.
  4. For an uploaded or hosted video file, uncheck Controls.


Step 4 matters for uploaded and hosted video files only: with Controls checked, the browser shows its own controls, and some browsers also show their own play button. For YouTube and Vimeo videos, the custom play button shows over the thumbnail until the visitor clicks it, whatever the Controls setting.


The custom play button doesn't show when Autoplay is on.


Turning on autoplay


Autoplay makes a video start playing by itself on the published page. To turn it on:


  1. Select the video element.
  2. In the Video settings, under Playback, check Autoplay. Sound turns off automatically.
  3. Preview the page on different devices and browsers to check how the video behaves.


Browsers limit autoplay, so a video with autoplay on doesn't always start by itself:


  • A video with autoplay plays without sound by default, because browsers block autoplay with sound.
  • If you check Sound again, the video only autoplays after the visitor has clicked on the page, for example in a popup that opens with a click.
  • On mobile, a video with autoplay and sound doesn't play by itself. It waits for the visitor to tap it.


For more on how browsers handle autoplay, see Google Chrome's autoplay policy.


Playback settings


The Playback options in the Video settings control how a video plays:


  • Autoplay: starts the video by itself. See Turning on autoplay.
  • Sound: plays the video with sound. Turning on Autoplay turns Sound off.
  • Repeat: plays the video in a loop.
  • Controls: shows the player controls. For a Vimeo video, unchecking Controls doesn't hide them: hide the controls in Vimeo's own settings instead.
  • Fill: makes the video fill the element's frame.


The sliders button next to Controls opens two more settings: Play button (a custom play button image) and Start at (sec): (the second at which the video starts).


For a background-style video, check Fill, Autoplay and Repeat, and uncheck Controls.


When scrub on scroll is turned on for the video, only Fill is shown under Playback.


YouTube and Vimeo videos also have a Quality setting (Automatic, 1080p, 720p or 360p). To find it, click the video's source row in the Video settings. In the same place, you can edit the link or choose another library video. To remove the video, click the trash icon Remove video next to the source row.


Frequently asked questions


Why doesn't my video autoplay?


Browsers block autoplay with sound. A Maglr video with Autoplay on plays without sound by default. If Sound is on, the video only autoplays after the visitor has clicked on the page, and on mobile it waits for a tap. Turn Sound off in the video element's Playback settings to let the video autoplay.



The video element accepts YouTube and Vimeo links, and links that start with http:// or https:// and end in .mp4 or .webm. Any other link turns the Paste a video link field red with the message "Use a YouTube or Vimeo link, or a link ending in .mp4 or .webm", and the link is not saved. For a video file on your computer, click Select from library and upload it to the media library instead.


How do I hide the controls on a Vimeo video?


Hide the player controls in the video's settings on Vimeo. Unchecking Controls in the Maglr video element doesn't hide the controls of a Vimeo video.


Why are some video settings greyed out?


In the mobile view of the editor, a video element that is also on the desktop layout takes its video from the desktop layout. Most of its settings are greyed out there: the video source, Repeat, Controls, Fill, Play button and Start at (sec):. Autoplay and Sound stay editable in the mobile view. Switch to the desktop view to change the other settings.


What is the maximum file size for an uploaded video?


A video file uploaded to the Maglr media library can be up to 100 MB. The media library accepts MP4, WebM and Ogg files; MP4 is recommended because it plays in the widest range of browsers. To make a video file smaller, see Reducing video file size.

Updated on: 16/10/2026