Back to Blog
Troubleshooting

Notion Embed Not Working? Complete Troubleshooting Guide

Alex Thompson
10 min read
Share:
notion embed not workingnotion embed problemsfix notion embednotion troubleshooting
NE

Common Issues

Quick Diagnosis

SymptomLikely CauseSolution

Blank embedPermission issueMake page public
Slow loadingLarge pageOptimize content
Wrong contentCachedClear cache, refresh
Mobile issuesResponsiveUse Notion Embed
Error messageVariousSee specific fixes

Loading Problems

Embed Won't Load

Check:

  • Is the page public?

  • Is the URL correct?

  • Is Notion online?
  • Fix:

  • Toggle share settings off/on

  • Copy a fresh URL

  • Check status.notion.so
  • Slow Loading

    Causes:

  • Large pages

  • Many images

  • Complex databases

  • Multiple embeds
  • Fixes:

  • Split into smaller pages

  • Optimize images

  • Simplify databases

  • Use Notion Embed for caching
  • Infinite Loading

    Try:

  • Clear browser cache

  • Disable extensions

  • Try incognito mode

  • Different browser
  • Display Issues

    Content Not Showing Correctly

    Check formatting:

  • Preview in Notion first

  • Check block types

  • Verify database views
  • Wrong Size

    Fix iframe:

    <iframe 
    src="YOUR_URL"
    style="width: 100%; min-height: 600px; border: none;"
    ></iframe>

    Mobile Display Problems

    Native iframes often fail on mobile. Solutions:

  • Test on actual devices

  • Use responsive wrapper

  • Use Notion Embed for mobile optimization
  • Permission Errors

    "Page Not Found" Error

    Causes:

  • Page not public

  • Wrong URL

  • Page deleted
  • Fixes:

  • Share → Share to web → Enable

  • Copy URL again

  • Verify page exists
  • "Access Denied" Error

    Check:

  • Public sharing is on

  • Correct workspace

  • No restriction settings
  • Platform-Specific Fixes

    WordPress

    Issue: Embed not rendering
    Fix: Use "Custom HTML" block, not regular embed

    Webflow

    Issue: Iframe blocked
    Fix: Use Embed element, not Rich Text

    Squarespace

    Issue: Code not executing
    Fix: Use "Code Injection" in correct location

    Wix

    Issue: Size constraints
    Fix: Use HTML iframe element with custom dimensions

    Advanced Troubleshooting

    Network Issues

  • Check browser console (F12)

  • Look for blocked requests

  • Verify HTTPS
  • CORS Errors

    Some customizations may cause CORS issues:

  • Use Notion Embed which handles CORS

  • Avoid direct API calls from browser
  • Caching Problems

    Force refresh:

  • Add timestamp to URL: ?t=123

  • Clear CDN cache

  • Use cache-busting techniques
  • When to Use Notion Embed

    Notion Embed solves many issues automatically:

  • ✅ Caching and performance

  • ✅ Mobile responsive

  • ✅ No permission issues

  • ✅ Cross-platform compatibility
  • Try Notion Embed →

    FAQ

    Why does my embed show "Page not found"?

    The page isn't public. Enable "Share to web" in Notion.

    How do I fix slow embed loading?

    Optimize your Notion page content, or use Notion Embed for caching.

    Why doesn't my embed work on mobile?

    Native iframes often have mobile issues. Use Notion Embed for responsive embeds.

    Can I embed password-protected pages?

    Not with standard embedding. Use Notion Embed Enterprise for authentication.

    Conclusion

    Notion embed troubleshooting usually comes down to:

  • Permissions - Make sure page is public

  • URL - Use correct, fresh URL

  • Performance - Optimize or use Notion Embed

  • Platform - Use correct embed method
  • Still stuck? Contact Notion Embed support

    ---

    Related: Embed Notion in Website | HTML Code

    AT

    Alex Thompson

    Content Creator at Notion Embed. Passionate about helping people share their knowledge with the world.

    View all posts →

    Frequently Asked Questions

    Why does my embed show "Page not found"?

    The page isn't public. Enable "Share to web" in Notion.

    How do I fix slow embed loading?

    Optimize your Notion page content, or use Notion Embed for caching.

    Why doesn't my embed work on mobile?

    Native iframes often have mobile issues. Use Notion Embed for responsive embeds.

    Ready to Transform Your Notion Content?

    Join thousands of creators, startups, and businesses using Notion Embed to power their websites. Get started in minutes.

    No credit card requiredSetup in 5 minutesCancel anytime