Skip to content

How to Fix Notion Embed Block Not Displaying Content

DodaTech Updated 2026-06-24 3 min read

In this tutorial, you'll learn about How to Fix Notion Embed Block Not Displaying Content. We cover key concepts, practical examples, and best practices.

Notion embed blocks display external content — websites, maps, videos, and PDFs — directly in your page. When the embed shows a blank space, a loading spinner that never resolves, or an error message, the URL is not supported, the site blocks embedding via X-Frame-Options, or the URL format is incorrect.

The Problem

You paste a URL into an embed block (type /embed or paste a link and select "Create embed"). The block shows a grey area, spins forever, or says "This URL cannot be embedded."

Wrong approach — pasting the URL as a link instead and losing the embedded preview.

The Fix

Check if the URL supports embedding:

Supported: YouTube, Vimeo, Google Maps, Twitter/X, Figma, CodePen, PDFs, GitHub Gists
Unsupported: Most websites block embedding via X-Frame-Options

For unsupported sites, use a workaround:

1. Take a screenshot of the content
2. Add the image to Notion
3. Below the image, paste the original URL as a text link
4. Users click the link to open the content in a new tab

For PDFs that do not render:

1. Ensure the PDF URL ends in .pdf
2. The PDF must be publicly accessible (not behind a login)
3. Google Drive PDFs work if shared with "Anyone with the link"

For Google Maps embeds:

1. Go to Google Maps → Share → "Embed a map"
2. Copy the iframe embed code (starts with <iframe...)
3. In Notion, paste the iframe code directly
4. The map appears in the embed block

Expected output:

Embed block shows the external content with full functionality
Interactive embeds (maps, videos) are usable within Notion
Content updates automatically when the source changes

Prevention Tips

  • Check if the website supports embedding before trying to embed it
  • Use screenshots + links for unsupported websites
  • Test embeds in a private Notion page before adding them to shared documents
  • Prefer native Notion blocks (Video, Image, Code) over embeds when possible
  • Keep embed URLs stable — if the source URL changes, the embed breaks

Common Mistakes with embed block

  1. Misunderstanding that String is [Char] with poor performance for large text operations
  2. Using foldl instead of foldl' causing stack overflow on large lists
  3. Forgetting deriving (Show, Eq) on custom data types needed for debugging

These mistakes appear frequently in real-world NOTION code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

### Why does Notion show "This URL cannot be embedded"?

The website has set X-Frame-Options: DENY or Content-Security-Policy: frame-ancestors 'none' headers, which prevent it from being displayed in embeds on other sites. Notion cannot bypass these security restrictions — they are controlled by the website owner.

Can I embed a page from another Notion workspace?

Yes, create a "Link to page" in the source workspace, copy the page link, and paste it into Notion. The embed shows the page title and a preview. The viewer needs access to the source workspace to open the page.

How do I resize an embed block in Notion?

Click and drag the edge handles of the embed block to resize it. You can also click the block and use the "..." menu to choose full width or page width. Some embeds (like YouTube) have fixed aspect ratios that limit resizing.

Related: DodaTech's Embed Compatibility Checker tests URLs against common embedding restrictions and suggests workarounds for sites that block embedding. Use with DodaZIP for page backup.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro