--- title: "18 – Video block" slug: "18-video-block" description: "Play a short MP4 video in your email with the Email CMS 2.0 Video block, and set a fallback image for clients that cannot play video." status: "update" updated: 2026-11-11T15:02:16Z published: 2026-11-11T15:02:16Z canonical: "docs.mapp.com/18-video-block" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # 18 – Video block ## Overview The Video block plays a short MP4 video directly in your email, in the email clients that support it. In clients that don't, it shows a static image with a play icon that links to your video online, so readers still see what looks like an embedded video. You set a poster image for before the video plays, a fallback image for clients that can't play video, and the link readers go to when they click. ## Before You Start The Video block needs four URLs. Prepare them before you edit the block, and save them in a .txt file so they're ready to paste in. Upload each file to the [**Content Store**](/v1/docs/content-store-window). To find an asset's URL, select the asset, scroll to the bottom of the page and copy the **URL for Download** link. | Asset | What it is | Where it goes | | --- | --- | --- | | 1. Video | Your video as an MP4 file. Keep it short and the file size small. | Video Link | | 2. Poster image | The image shown before the video plays, for example the opening frame or a call to action. Don't add a play icon, the email client or browser adds one. | Video Poster Image URL | | 3. Hosted video URL | The link to where your video is hosted, for example YouTube, your website, a Mapp Engage landing page or the Content Store. Host your video first, then copy its URL. | Fallback Video Link | | 4. Fallback image | The static image shown in email clients that can't play video. It can be the same as your poster image, but it must include a play icon. | Fallback Image URL | ## Default Block View **Desktop** ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/18-Video_Block_Desktop.png) **Mobile** ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/18-Video_Block_Mobile.png) ## Settings All settings are in the **Details** tab of the right-hand panel, in two groups. ### 01. Block Layout ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/18-Video_Block_Details_Tab_01_Layout.png) | Field | What it does | Default | | --- | --- | --- | | Block Background Colour | The colour behind the video. Use a six-digit HEX value, for example #ffffff. | #ffffff | This is the colour that will be displayed in an email just before the video loads. ### 02. Video Settings ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/18-Video_Block_Details_Tab_02_Video.png) | Field | What it does | Default | | --- | --- | --- | | Video Link | The URL of your MP4 video (Asset 1). | .../mapp-video.mp4 | | Video Poster Image URL | The image shown before the video plays (Asset 2). The email client or browser adds the play icon. | .../preview_image.png | | Fallback Video Link | Where readers go when they click the video in an email client that can't play it (Asset 3). | [https://www.youtube.com/watch?v=jfha5FPDBAk](https://www.youtube.com/watch?v=jfha5FPDBAk) | | Fallback Image URL | The image shown in email clients that can't play video (Asset 4). This image must include a play icon. | .../video_poster.png | > [!NOTE] > Note > > The default values are sample assets that come with the block. Replace them with your own before you send. ## Video and Fallback Views What readers see depends on whether their email client can play video. | Video view | Fallback view | | --- | --- | | ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/compatible_device(1).png) | ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/non-compatible_device.png) | | The poster image shows with a play icon, which is added by the email client or browser of the device. The video plays in the email. | The fallback image shows instead. Clicking it opens the Fallback Video Link. | ## Tips - **Keep the video short.** A small file loads faster when the email is opened. - **Only the fallback image needs a play icon.** The email client or browser adds a play icon to the **poster image**, so adding your own would display two icons. - **Make the fallback look like the video.** Use your poster image with a play icon added, so readers in every email client see what looks like a video. You could even add an animated GIF that would seem like a video. - **Host your video before you start.** The Fallback Video Link must point to a live video, or readers who can't play it in the email have nowhere to go. - **Upload your files to the Content Store**, so they're hosted by Mapp when your email is opened. Files are deleted when they expire, so if you set your own expiration date, choose one well after the last time readers are likely to open the email. - **Test before you send.** [Send yourself a test email](/v1/docs/send-test-message-to-test-recipients) and check both the video and the fallback view. ## Email Client Support The video plays in the email in Apple Mail on iPhone and Mac. On iPhone, readers tap play to start it, as the video doesn't play automatically. In every other email client, the fallback makes sure no reader misses out: - **Your email looks the same everywhere.** Readers see your fallback image with its play icon, so the design stays intact and still looks like an embedded video. - **One click to watch.** Clicking the image opens your video online, on YouTube, your website or a Mapp Engage landing page. - **Nothing breaks.** Readers never see an empty space or a broken player where the video would be. See [Email CMS: Tested Email Clients and Devices](https://docs.mapp.com/docs/email-cms-tested-email-clients-and-devices) for our full test list. **Compatibility list in full** | Apple Mail | iPhone 16, 16 Pro, 16 Pro Max, iOS 18 | Video | | --- | --- | --- | | Apple Mail | iPhone 17, 17 Pro, 17 Pro Max, iOS 26 | Video | | Apple Mail | iPhone 18 Pro, iOS 27 | Video | | Apple Mail 16 | macOS 13 | Video | | Outlook Microsoft 365 | macOS 13 | Fallback image | | Gmail App | Pixel 7, 8, 9 and 10, Android 13 to 16 | Fallback image | | Gmail App | iPhone 16, iOS 26 | Fallback image | | Outlook App | iPhone 13, iOS 15 | Fallback image | | Classic Outlook (Microsoft 365) | Windows 11 | Fallback image | | New Outlook for Windows | Windows 11 | Fallback image | | Outlook 2019, 2021 and 2024 | Windows 10 and 11 | Fallback image | | AOL, Gmail.com, GMX, Microsoft365.com, Outlook.com, Web.de, Yahoo | Chrome and Firefox, Windows 10 | Fallback image | | Free.fr, Libero, T-Online | Chrome and Firefox, Windows 10 | Fallback image |