> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uplifter.app/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I add a video to my website, or play one behind a section?

> Add a YouTube, Vimeo or uploaded video to a custom page with the Video widget, or play your own video file muted behind a page section.

> [!NOTE]
>
> **Must know**
>
> * **Needs Website Customization.** Videos go on custom pages you build in the page builder.
> * **MP4 or WebM, up to 15 MB.** That's about 15 seconds of phone video. Export an iPhone .mov as MP4 before you upload it.
> * **Two ways to show it.** A **Video** widget with **Source** set to **Video file** plays when a visitor presses play. A section's **Background video** plays muted behind the section after its still picture.
> * **Some visitors see the still.** Visitors who prefer reduced motion, use data saver or are on a slow connection see the still picture instead of a background video.

## Add a video widget

**1. Add the widget**

On a custom page from **Settings > Website > Pages**, click **Add widget** and pick **Video**. Its settings open.

**2. Choose a Source**

For **YouTube or Vimeo link**, pick the **Provider** and paste the **Video link or ID**. For **Video file**, click **Upload video** and pick an MP4 or WebM. **Title (optional)** works for both.

**3. Check the still picture and click Save**

For a video file, Uplifter takes the **Still picture** from the video's first frame; swap it with **Upload new** or **Choose from library**. **Replace video** and **Remove video** change the file later. Then click **Save**.

## Play a video behind a section

**1. Open Section settings**

Hover over a section and click its tab (**Section 1**, for example), or click **Add section**.

**2. Upload the Background video**

Under **Background video**, click **Upload video** and pick an MP4 or WebM. A still picture is made for you, or add your own under **Still picture**.

**3. Set Align content and click Save**

**Top** is the default. **Middle** centers the section's widgets between its top and bottom on larger screens.

**Watch it play.** The canvas shows only the still, with a **Background video** or **Content: middle** chip on the section. Click **Preview** to see it play. On your site it plays muted and on a loop once the page has loaded, with a pause button. A header or footer section can't have one.

**While it uploads.** **Save** waits. Closing the panel asks "Stop the upload?" (**Stop upload** or **Keep uploading**).

**If a file is refused.**

| Message starts | Fix |
| - | - |
| "practice.mp4" is over 15 MB. | Trim it to about 15 seconds, then upload it again |
| "IMG\_0412.mov" is not an MP4 or WebM video. | Export it as MP4 (iMovie and HandBrake are free) |
| This file isn't an MP4 or WebM video inside. | Renaming a .mov doesn't work. Export it as MP4 |

**Draft and publish.** On a page that's switched on (showing on your site), video changes wait in your draft until you click **Publish**. Removing a background video there says "Removed. Until you publish, Discard changes brings it back." One exception: if a video has no still yet (say, one brought across from your old site), opening the page grabs one and puts it on the live page and any draft at once.

**Change layout** replaces your sections, so their background videos and alignment go too. **Undo** brings them back.

**Your files.** Uploaded videos show in **Settings > Organization > Organization Assets** as Type **Videos** (stills as **Images**), and count as in use while a page or its draft holds them.

**Moving from Uplifter 1.0?** Your old site's videos come across: one behind content becomes a section's background video, the rest **Video** widgets.

**Related:** [How do I choose a page layout and add full-width sections?](https://docs.uplifter.app/club/website-store/choose-a-page-layout.md) · [What does each website page widget do?](https://docs.uplifter.app/club/website-store/website-widgets.md) · [How do I see and clean up the files my club has uploaded?](https://docs.uplifter.app/club/website-store/manage-organization-assets.md) · [Should we keep our current website look or start fresh?](https://docs.uplifter.app/migrating-from-1-0/bring-your-old-website-across.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.