18 – Video block

Prev Next

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. 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

Mobile

Settings

All settings are in the Details tab of the right-hand panel, in two groups.

01. Block Layout

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

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

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

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

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 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 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