N Notion

How to embed videos and media files on Notion

beginner 8 min read Updated 2026-03-18
Quick Answer

Embedding videos and media in Notion is simple - type /embed or /video, paste your URL, or drag files directly onto the page. Notion supports YouTube, Vimeo, images, PDFs, and many other media formats that can be embedded as interactive blocks.

Try Notion Full Notion Review

Prerequisites

  • Active Notion account
  • Access to the page where you want to embed media
  • URL or file ready to embed
  • Basic understanding of Notion's block system

Step-by-Step Instructions

1

Access your Notion page

Open Notion and navigate to the page where you want to embed your media. Click anywhere on the page to position your cursor where you want the media to appear.
2

Choose your embedding method

You have three options:
• Type /embed for general media embedding
• Type /video specifically for video content
• Type /image for image files
• Or simply drag and drop files directly onto the page
The /embed command works for most media types, while specific commands like /video give you more targeted options.
3

Paste or upload your media

If using a command, paste the URL of your media (YouTube, Vimeo, Google Drive, etc.) into the input field that appears. For files, either paste the URL or click Upload to select files from your computer. Press Enter to confirm.
Notion supports direct uploads up to 5MB on free plans and larger files on paid plans.
4

Adjust media settings

Once embedded, click on the media block to see options. Use the ⋮⋮ handle to drag and resize the media. Click the media itself to access settings like Caption, Link to original, or Replace.
Adding captions helps with organization and accessibility.
5

Configure display options

Right-click the media block or click the ⋯ menu to access options like:
• Copy link
• Rename
• Comment
• Delete
• Turn into (convert to different block types)
6

Test embedded media functionality

Click play on videos to ensure they work properly. For PDFs and documents, verify they open and display correctly. Check that images load at the appropriate resolution and that external links open properly.
Some embedded content may require internet connection to display properly.
7

Organize with columns and layouts

To create side-by-side media, type /column or drag media blocks next to each other. You can also use /divider to separate different media sections for better organization.
Column layouts work great for comparing images or creating media galleries.

Common Issues & Troubleshooting

Video won't embed or shows 'Embed failed' error

Ensure the URL is public and supports embedding. Try copying the direct share/embed URL instead of the browser URL. Some platforms like Instagram or TikTok may have embedding restrictions.

Uploaded file is too large or won't upload

Free Notion accounts have a 5MB file limit. Compress your files or upgrade to a paid plan for larger uploads. Alternatively, upload to Google Drive or Dropbox and embed the sharing link.

Media appears too small or large

Click and drag the resize handles on the corners of the media block. For images, you can also click the image and select Original, Page width, or Full width from the sizing options.

Embedded content not loading or showing blank

Check your internet connection and refresh the page. Verify the source URL is still valid. Some embeds may be blocked by privacy settings - try accessing the page in an incognito window.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Notion website before purchasing.
Visit Notion View Notion Pricing