Google Chat Link Preview Not Working? Here is How to Fix It

Why your Google Chat link preview shows a plain URL with no image or wrong title — and what to fix.

How Google Chat builds link previews

Google Chat fetches your page's HTML server-side and reads Open Graph meta tags to render a link preview card with a title, description, and image. Google Chat uses the same infrastructure as other Google services, so it follows redirects and reads standard OG tags.

The minimum tags Google Chat needs for a rich preview:

<meta property="og:title"       content="Your Page Title" />
<meta property="og:description" content="A short summary of the page." />
<meta property="og:image"       content="https://yourdomain.com/og/page.png" />
<meta property="og:url"         content="https://yourdomain.com/page" />

1. Missing OG meta tags

The number one reason for broken Google Chat previews is simply not having OG tags in your HTML. Check your page source:

# Verify OG tags are present in the HTML:
curl -sL https://yourdomain.com/page | grep -i 'og:'

# Expected output:
# <meta property="og:title" content="Your Title" />
# <meta property="og:description" content="..." />
# <meta property="og:image" content="https://..." />

# If nothing shows up, add OG tags to your <head>.

Fix: Add the four essential OG tags shown above to your page's <head>.

2. og:image URL issues

Google Chat requires your og:image URL to be:

Absolute — must start with https://
Publicly accessible — no auth, no login wall
Valid image format — JPG, PNG, or WebP
Reasonable size — under 5MB, ideally 1200×630px

<!-- ❌ Relative URL — won't work -->
<meta property="og:image" content="/images/og.png" />

<!-- ❌ HTTP without S — may be blocked -->
<meta property="og:image" content="http://yourdomain.com/og.png" />

<!-- ❌ Requires authentication — bot can't access -->
<meta property="og:image" content="https://private-cdn.com/og.png?token=abc" />

<!-- ✅ Correct — absolute HTTPS URL, publicly accessible -->
<meta property="og:image" content="https://yourdomain.com/og/page.png" />

3. JavaScript-only rendering (SPA)

Google Chat's link preview bot does not execute JavaScript. If your app is a client-rendered SPA (React, Vue, Angular without SSR), the bot sees an empty page with no OG tags.

Fix: Use SSR (Next.js, Nuxt, SvelteKit) or SSG so OG tags appear in the initial HTML. Alternatively, use a prerendering service that serves static HTML to bot user agents.

4. Google Workspace admin settings

If you're using Google Chat through a Workspace organization, an admin may have disabled link previews. Check with your Workspace admin:

# Google Workspace Admin Console:
# Apps → Google Workspace → Google Chat → Sharing settings
#
# Ensure "Link previews" is enabled.
#
# Some organizations restrict link previews to internal domains only.
# If your link is to an external site and previews are disabled
# for external URLs, the admin needs to update this policy.

5. Google Chat cache

Google Chat caches link preview data. If you've updated your OG tags but the old preview still shows:

Wait 24–48 hours — Google Chat's cache typically refreshes within this window.
Use a query parameter — Share the URL with ?v=2 or ?ref=chat appended to force a fresh fetch.
Google has no public debugger for Chat — unlike Facebook's Sharing Debugger, there's no tool to force-clear the Google Chat cache.

Complete OG tag template

<head>
  <title>Your Page Title</title>

  <!-- Open Graph -->
  <meta property="og:title"       content="Your Page Title" />
  <meta property="og:description" content="A concise description under 200 chars." />
  <meta property="og:image"       content="https://yourdomain.com/og/page.png" />
  <meta property="og:image:width" content="1200" />
  <meta property="og:image:height" content="630" />
  <meta property="og:url"         content="https://yourdomain.com/page" />
  <meta property="og:type"        content="website" />

  <!-- Twitter Card (also helps some platforms) -->
  <meta name="twitter:card"        content="summary_large_image" />
  <meta name="twitter:title"       content="Your Page Title" />
  <meta name="twitter:description" content="A concise description." />
  <meta name="twitter:image"       content="https://yourdomain.com/og/page.png" />
</head>

Verify your Google Chat link previews

After fixing your tags, paste your URL into OGFixer to preview how Google Chat, Slack, Discord, and other platforms will render your links.