Working with the video element

💡 Follow the instructions here to upload a new video to your Media Library

In this article

Add a video to your page

Replace a video

Accessible (& unbranded) video player

Set videos to autoplay

Element settings

Add a video to your page

You can add a video to your page using the video element. In the elements tab on the left-hand side of the editor, drag the video element into a column.

💡When you're working with the Content Builder, it's not possible to add a video to your page. They're included in block templates.

Your library will open. You can select an existing video or add a new one.

To add an existing video to your page, click on the check mark on the video and then click the Choose button to add it to your page.

💡Your audience can decline targeting cookies. In doing so, they also decline cookies from the video platform where your video is hosted. This results in videos being blocked. Learn more about What happens when a visitor declines cookies.

Replace a video

You can replace a video by clicking the replace icon in the blue element bar. This opens the media library, where you can select a new video.

Accessible (& unbranded) video player

With our accessible video player, you can make all the video elements in your Doc more inclusive. This option improves keyboard navigation and screen reader compatibility. As a bonus, it also removes platform branding from YouTube, Vimeo, Wistia, Brightcove, and self-hosted videos!

💡 This setting applies only to video elements. Background videos remain unchanged.

To enable the accessible (& unbranded) video player, open your Doc in the editor and go to the Doc settings in the Menu.

Navigate to the Accessibility section and toggle on the Accessible video player option. Click Save.

Once enabled, all video elements in your Doc will automatically switch to the accessible player. The result? A sleeker, more inclusive video experience for every viewer!

Set videos to autoplay

Do you want your videos to automatically play as your audience scrolls through your page? You can enable autoplay directly in your video element settings.

Here’s how to enable autoplay:

Hover over the video and click the cogwheel icon ⚙️ to open the element settings.
Go to General settings and toggle on Autoplay.

Once enabled, your video will autoplay based on the viewer's scroll position:

In view? It plays. When the video is at least 50% visible on the screen, it begins playing automatically.
Out of view? It pauses. When the video is less than 50% visible, it pauses. Scroll back, and it resumes where it left off. Autoplay also pauses when the viewer switches tabs.
Muted by default. To ensure a smooth experience, autoplayed videos are muted. Viewers can manually enable audio.
Only one plays at a time. If multiple videos are in view with autoplay enabled, only the first video meeting the 50% threshold will play. We call this the “First in View” principle.

Autoplay video element_HC

Element settings

You can style your video element to fit your design.
Hover over the video and click the cogwheel icon to open the element settings.

💡When working with the Content Builder, you'll have limited element settings. You can only replace videos in block templates.

General settings
From the general settings, you can turn on the toggle if you want your video to autoplay.

Autoplay video element

Border
Add a border around your video. You can apply the same border weight on all sides or adjust each side individually. All borders will use the same selected color.

Shadow
Add shadows to your video element and adjust the color, position, and blur radius.

Spacing
Add extra space below the video to create distance from the next element.

Alignment
Set the alignment to either left, center, or right.

Visibility
Show or hide the video in desktop, tablet, or mobile view modes.

Animation
Select an entrance animation that will play when the page is opened.