How to Fix Notion Embed Block Not Displaying Content
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
- Misunderstanding that
Stringis[Char]with poor performance for large text operations - Using
foldlinstead offoldl'causing stack overflow on large lists - 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
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