Notion Link Preview Not Working: Fix Missing OG Images in Embeds

Fix broken or missing link previews when pasting URLs into Notion — why Notion reads og:image differently, what it falls back to, and how to control it.

How Notion reads link previews

When you paste a URL into Notion and click "Create bookmark" (or turn it into a bookmark block), Notion fetches the page server-side and reads its og:title, og:description, and og:image meta tags. If those tags are missing or broken, Notion falls back to the page title and either a generic icon or no image.

Common reasons Notion link previews break

  1. No og:image meta tag: Notion won't show an image at all. Add <meta property="og:image" content="https://..." /> to your page's <head>.
  2. Relative URL for og:image: Notion's scraper requires an absolute URL including protocol and domain. /images/og.png will fail. Use https://yourdomain.com/images/og.png.
  3. Image behind authentication: If your og:image URL returns a 401 or redirect to a login page, Notion can't load it.
  4. SPA — no server-side rendering: Notion's scraper doesn't run JavaScript. If your app is a React/Vue SPA that sets meta tags via JS, Notion will see a blank page without any OG tags. You need SSR or prerendering.
  5. Cached old preview: Notion caches bookmark previews. If you updated OG tags after the first paste, delete the bookmark block and paste the URL again — this triggers a fresh fetch.

How to force Notion to re-fetch a link preview

  1. Click on the bookmark block in Notion
  2. Click the three-dot menu (···)
  3. Select Delete
  4. Paste the URL again and press Enter
  5. Click Create bookmark — Notion will fetch fresh OG data

There's no "refresh" option on existing bookmarks — deletion and re-paste is the only way to force Notion to re-scrape.

Notion-specific gotchas

  • Image dimensions: Notion displays bookmark images at roughly 200×100px in the bookmark card. Use a 1200×630px source image — Notion will scale it down correctly.
  • og:title fallback: If og:title is missing, Notion uses the HTML <title> tag.
  • Mention vs bookmark: When you @-mention a URL (inline), Notion shows a text link — not the full bookmark card with image. For the image preview, you need a full bookmark block.

Verify your OG tags before pasting into Notion

Paste your URL into OGFixer to confirm your og:title, og:description, and og:image are all present and valid before embedding in Notion.

Related guides