How to add a video to a slide in Keynote on Mac: step by step

Two things decide whether the video works: the file and your version of Keynote. Apple says a video must be in a format QuickTime can play on your Mac, and it suggests a QuickTime .mov file. Apple's support pages also list Keynote 15.4 for Mac, which requires macOS 26 or later. Check both before you start, so you don't lose ten minutes to a file that won't import.

Check the video file and your Mac first

Start with a quick test. Open the video in QuickTime Player. If it plays there, Keynote is more likely to accept it. If QuickTime can't open it, Keynote is unlikely to play it either, and you should convert the file first. Apple's own check is to select the file in Finder and press Command-I to read its Kind. That shows the real format, which helps when a file extension looks wrong.

• Format: a file QuickTime can open. Apple suggests .mov.
• Keynote version: Keynote 15.4 for Mac, according to Apple's Creator Studio page.
• macOS: macOS 26 or later for Keynote for Mac, according to the same page.
• File size: a presentation over 500 MB may run better when saved as a package file.
• Internet: needed only if the video is a YouTube or Vimeo link.

Add a video from your Mac with Insert Media

This is the method Apple documents first. Select the slide, click the Insert Media button in the toolbar, then click Choose Photos or Videos. Pick the file and drop it onto the slide. The steps below follow that order, with the keyboard shortcut at the end for people who prefer to skip the menus.

Plan the slide before you add the clip. Leave room around the video for a title or a caption. A video that fills the whole slide can hide labels you still need. You don't have to use full screen. You can shrink the clip and place it beside your text.

Drag a video in from Finder

Dragging is often faster than the menus. Open the folder with your video in Finder, then move the Finder window so you can see the slide in Keynote at the same time. Drag the video file onto a media placeholder, or anywhere else on the slide. Apple's guide says both drop targets work.

If the Finder window covers the slide, shrink it first. Dragging works best when both windows are fully visible. Drop the file too early and it lands on the wrong slide, so check the thumbnail on the left before you let go.

Use a media placeholder for the video

A media placeholder is a spot on the slide that waits for media. Apple's keyboard shortcut list calls the command Define the object as a media placeholder, and the shortcut is ⌃⌥⌘I. Select the shape you want to use, press that shortcut, then drag your video onto it. Use this when a slide design already has an area for pictures or video. If you don't see a placeholder, drop the video anywhere on the slide instead.

Add a YouTube or Vimeo video with a link

A web video stays on the internet. The slide holds a link, not the video file, so the presentation stays small. The trade-off is simple. The video needs a connection when you present, so test on the network you will use on the day.

1. Click the Insert Media button in the toolbar.
2. Choose Add Web Video.
3. Type or paste the YouTube or Vimeo link.
4. Click Insert.

Apple says web video needs an internet connection to play. Check that it plays in the slideshow, not just in the editor. If the venue Wi-Fi is weak, keep a local copy of the same clip ready as a backup.

Set when the video plays

Apple's guide is not consistent here. One sentence says a video plays when its slide appears. Another says that by default the video and audio plays when you click it during a presentation. Don't trust either one blindly. Build a test slide, run the slideshow, and watch what happens on your version.

Replace a video you already added

Replacing keeps the slide and swaps in a new clip. Select the video on the slide. Open the Format sidebar. Click the Movie tab, then click Replace, and pick the new file. The Format sidebar also has Movie, Audio and Web Video tabs, so check which tab is open if you don't see Replace.

Fix a video that won't import or play

Start with the file, not with Keynote. Apple suggests checking whether the file is damaged or in an unsupported format. Then check for macOS updates, and try an app that supports the format, such as QuickTime Player. If the file plays in QuickTime but not in Keynote, the format or a Keynote setting is the likely cause.

Keynote can also convert some formats as you add them. Open Keynote > Settings > General. Under Adding Media, you'll see two checkboxes: Optimize media for iPhone, iPad, and Apple Vision Pro, and Optimize media for older devices. With both on, HEVC, HEIC and ProRes convert to H.264, JPEG or PNG. The settings apply only to media you add after the change.

Shrink a presentation that got too big

Video makes presentations big fast. Apple's Reduce File Size tool sits in the File menu. Go to File > Reduce File Size, choose a movie option, then set Movie Quality, which sets the maximum resolution of your video. Work on a copy while you learn how the tool behaves.

• Most compatible (H.264): the first movie option Apple lists.
• High efficiency (HEVC): the second movie option Apple lists.
• Preserve original format: keeps the video in its current format.

Read the warnings. Apple says a mix of options can make the file larger, so check the size after you save. Reduce This File changes the original. Reduce a Copy leaves the original unchanged. For a first attempt, use Reduce a Copy.

If the presentation is over 500 MB, or holds large video or image files, Apple says Keynote may run better as a package file. Some web and email services don't accept package files. Export a copy in a format the other person can open before you send it.

Limits with Keynote for iCloud

Keynote for iCloud handles video differently from the Mac app. Apple says it cannot add a new live video object there. Existing live video objects can be edited, but they don't access your camera when you present. On iCloud.com, movies and audio don't play during slide transitions. The soundtrack and recorded voiceover don't play either.

Playback works in Keynote for Mac, iPhone and iPad. Apple's iCloud page doesn't say whether YouTube or Vimeo web videos play in Keynote for iCloud. Don't assume they do. If your slide uses a web video, build and test it in Keynote for Mac.

Add subtitles to a video

Subtitles need macOS 26.4 or later, according to Apple's guide. Start the slideshow from the Play button, click the video, then click Closed Captions. Check that option on your version before you promise captions to an audience.

Mistakes people make with video in Keynote

• Testing only in edit view. Apple says videos play on click during a presentation, so run the slideshow.
• Dropping in a file QuickTime can't open, then blaming Keynote.
• Turning on the optimize settings and expecting old videos to change.
• Using Reduce This File and losing the original clip.
• Relying on a web video at a venue with unreliable internet.

Each of these costs time on the day you present. Find them a day early, and the slide behaves the same on stage.

What to do next

Once the video plays, you may want to share the slides as a film. Read How to export a presentation as a movie in Keynote on Mac. If you present from notes, How to add presenter notes in Keynote on Mac covers the next step.