Skip to content
Tutorials Center
My learning

Topics

Lesson 9 of 36 ยท Pages and Blocks

Embeds, Files and Media

Add images, videos, PDFs, files, bookmarks and live embeds from Figma, Google Maps and more to Notion pages, and learn the limits that apply.

Pages are not only text. You can drop in pictures, PDFs, videos, audio, whole websites and live documents from other tools. This lesson covers each media block, how to upload or link them, and what to watch for with size, sharing and performance.

Media blocks

Use the slash menu to add them:

Slash command What it adds
/image An uploaded image, a pasted link, or an Unsplash photo
/video An uploaded video file or a link to YouTube, Vimeo and similar
/audio An uploaded audio file or link
/file Any file attachment (document, ZIP, spreadsheet)
/pdf A PDF that shows inline as a viewer
/bookmark A preview card for a web link
/embed An interactive embedded page
/code or /equation Not media, but placed the same way

You can also paste an image from the clipboard or drag a file from your computer onto the page.

Add media three ways

Upload Stored in Notion, with plan size limits.
Link Points at the file on the web.
Paste or drag Fastest for screenshots.
1 / 2

Images

Click an image to resize it by dragging its corners, align it left, centre or right, add a caption and add alt text (via the block menu, Alt text). Alt text describes the image for screen readers and helps in search; always write it for meaningful images. You can also set an image as a page cover or icon from the page header.

Large images slow pages. Compress screenshots before uploading, and prefer a few well-chosen images to dozens of pasted ones.

Files and PDFs

A file block shows the file name and size and downloads on click. A PDF block renders pages in a viewer so readers do not have to leave. Upload limits depend on your plan; on free plans a single file has a modest cap, while paid plans allow much larger uploads. Check Notion's current limits before planning to store videos or datasets.

Bookmarks and embeds

A bookmark turns a URL into a card showing title, description and thumbnail. An embed goes further: it shows the real page, and many services render interactively. Supported services include design, maps, video, code, document and form tools, such as Figma, Google Maps, Google Docs, YouTube, Loom, Miro, GitHub Gists and CodePen. If a service does not support embedding, Notion shows a bookmark instead.

Paste a share link of the right type. Many tools need you to enable public or "anyone with the link" viewing for the embed to render for your readers, so test the page while signed out or in a private window.

An embed shows another service's content. Anyone who can open your page may be able to see that content, even if you did not intend it. Check the source's sharing settings before embedding private material.

Making media accessible and reliable

  1. Add captions and alt text.
  2. Do not rely on a link to a file that someone could move; upload important files or keep them in a shared drive with stable access.
  3. Keep a note of the original source of every embedded file.
  4. For video, add a short text summary so readers can decide whether to watch.

A media checker in code

This stand-in checks a list of media blocks for missing alt text and oversized files, the kind of check you might do manually before sharing a page. Notion has no such function; this is for learning.

JS Media audit (stand-in)

Press Run (or Ctrl + Enter) to see the console output here.

No output.

JS Which block for this link? (stand-in)

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Check your understanding

Quick check ยท 3 questions

of 3 answered You scored / 3 ยท perfect!

  1. 1. What is the difference between a bookmark and an embed?

    A bookmark shows a static preview of a link, while an embed displays the interactive page.
  2. 2. Why add alt text to an image?

    Alt text is the accessible description of the image.
  3. 3. What should you check before embedding private content?

    An embed can reveal source content to anyone who opens your page, so verify its sharing settings.

Summary

  • Add media with slash commands, paste, drag and drop or links.
  • Bookmarks preview links; embeds show interactive content; file and PDF blocks attach documents.
  • Always add alt text and check size and sharing limits.
  • Test embeds while signed out.

Next: Database Basics