⚠ Warning Open Graph

og:description Contains a URL — Write a Human-Readable Summary

The og:description should be a human-readable summary, not a URL.

What's the issue?

Your og:description starts with a URL (e.g., http:// or https://). The description meta tag should contain a human-readable summary of your page, not a web address.

Why this happens

Common causes:

A CMS or plugin auto-generating the description from page content
Copying the wrong value during development
A template variable resolving to a URL instead of text

Impact on social sharing

When your link is shared with a URL as description:

Users see a meaningless link instead of a compelling summary
Click-through rates drop significantly — users don't know what to expect
It looks broken — most users will assume the metadata is misconfigured
Social platforms may ignore it — some platforms filter out URL-only descriptions

How to fix it

Replace the URL with a descriptive summary:

<!-- Bad: URL as description -->
<meta property="og:description" content="https://example.com/products/widget-pro" />

<!-- Good: human-readable description -->
<meta property="og:description" content="Widget Pro: the fastest, most reliable widget for modern web apps. Free tier available with unlimited API calls." />

Prevention tips

Validate meta tags before deploying — Use tools like OpenGraph.to
Check CMS settings — Ensure your CMS generates proper descriptions
Set fallback descriptions — Configure a default description for pages without custom ones
Review template variables — Make sure dynamic values resolve to text, not URLs

Check your Open Graph tags

Related articles

Missing og:title

The og:title tag is essential for social sharing. Without it, platforms will use the page title or URL.

og:title Is Too Long

Titles longer than 60 characters may be truncated on social platforms.

og:title Is Too Short

Short titles may not be descriptive enough for social sharing.

Missing og:description

The og:description tag provides a summary of the page content for social platforms.

og:description Is Too Long

Descriptions over 160 characters may be truncated on social platforms.

og:description Is Too Short

Short descriptions miss the opportunity to engage users.

OpenGraph MCP Server

Inspect OG tags directly from your editor

The OpenGraph MCP server lets you inspect and analyze Open Graph meta tags directly from your AI-powered editor or assistant. It provides two tools:

inspect_og — Fetch and score OG tags for any URL
suggest_og_tags — Generate recommended meta tag HTML

Add the server to your project's .cursor/mcp.json file:

{
  "mcpServers": {
    "opengraph": {
      "command": "npx",
      "args": ["-y", "opengraph-mcp"]
    }
  }
}

Restart Cursor after adding the configuration.

Add to your .vscode/mcp.json file (requires GitHub Copilot extension):

{
  "servers": {
    "opengraph": {
      "command": "npx",
      "args": ["-y", "opengraph-mcp"]
    }
  }
}

Make sure you have GitHub Copilot with MCP support enabled.

Add to your claude_desktop_config.json file:

{
  "mcpServers": {
    "opengraph": {
      "command": "npx",
      "args": ["-y", "opengraph-mcp"]
    }
  }
}

The config file is at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Add to your ~/.codeium/windsurf/mcp_config.json file:

{
  "mcpServers": {
    "opengraph": {
      "command": "npx",
      "args": ["-y", "opengraph-mcp"]
    }
  }
}

Restart Windsurf after modifying the configuration.

Add to your Zed settings.json under context_servers:

{
  "context_servers": {
    "opengraph": {
      "command": {
        "path": "npx",
        "args": ["-y", "opengraph-mcp"]
      }
    }
  }
}

Open settings with Cmd+, and add the configuration.

Usage examples

▶ "Inspect the OG tags of github.com"

▶ "Suggest OG meta tags for my website https://example.com"

▶ "Check if my blog post has proper Open Graph tags"