Back to All Formats

OG.json

OG.json is a JSON-encoded version of Open Graph metadata, providing a centralized, machine-readable format for social preview data that AI systems can parse more easily than dispersed HTML meta tags.

og.json
Since 2023 (JSON format)
2023 (JSON format)
First Released
4/5
GEO Score

Origin & Background

Creator
Community-driven (based on Open Graph Protocol by Facebook)
Year Introduced
2023 (JSON format)
Alternate Names
Purpose
Created to provide a cleaner, more parseable alternative to HTML meta tags for social preview data, making it easier for AI systems to extract and use metadata.
Official Specification
View Specification

Key Benefits & Advantages

Benefits Overview

  • Centralizes social metadata in one parseable file
  • Easier for AI systems to extract than HTML meta tags
  • Provides ready-to-use summaries for AI-generated previews

Technical Advantages

Single source of truth for social metadata
Easier for AI to parse than dispersed HTML tags
Improves likelihood of accurate previews in AI answers
Reduces duplication and maintenance overhead
Provides structured data for link previews
Helps AI systems generate accurate summaries
Essential for social sharing and AI-rendered previews
Cleaner than managing multiple meta tags

SEO / GEO / LLMO Relevance

OG.json provides AI systems with ready-to-use summaries and metadata, improving the likelihood of accurate previews and citations in AI-generated content and featured snippets.

Improves accuracy of AI-generated link previews
Provides structured metadata for AI summarization
Increases likelihood of featured snippets
Helps AI systems understand page purpose and content
Essential for social sharing and AI-rendered previews

Implementation Guide

Syntax Example

og.json
Reference
{
  "title": "Geordy - Optimize Your Site for AI Search",
  "description": "Generate 16 AI-optimized formats automatically. Track AI bot crawls. Increase LLM visibility.",
  "image": "https://geordy.ai/og-geo-platform.jpg",
  "image:width": "1200",
  "image:height": "630",
  "image:alt": "Geordy AI Optimization Platform Dashboard",
  "url": "https://geordy.ai",
  "type": "website",
  "site_name": "Geordy",
  "locale": "en_US",
  "locale:alternate": ["es_ES", "fr_FR"],
  "keywords": ["GEO", "AI optimization", "LLM visibility", "generative search", "ChatGPT", "Claude"],
  "author": "Geordy Team",
  "published_time": "2024-01-15T10:00:00Z",
  "modified_time": "2024-01-15T14:30:00Z"
}

Troubleshooting & Best Practices

Comparison to Alternative Formats

Alternative Formats
When to Use OG.json

Use og.json to centralize social metadata in a single, parseable file. Especially valuable for sites with many pages or dynamic content where managing HTML meta tags becomes cumbersome.

Advantages

  • +Centralizes metadata in one file
  • +Easier for AI to parse than HTML tags
  • +Reduces duplication and maintenance
  • +Provides structured, machine-readable format

Limitations

  • −Relatively new format with limited adoption
  • −May need to maintain HTML meta tags for compatibility
  • −Requires keeping synchronized with page content
  • −Not yet universally recognized by all platforms

Popular Use Cases

Social Sharing

Provide rich previews when links are shared on social platforms

Example:
Content sites, blogs, product pages

AI-Generated Previews

Help AI systems create accurate link previews and summaries

Example:
SaaS platforms, documentation, landing pages

Link Metadata

Provide structured metadata for any link to your site

Example:
All websites wanting consistent link previews

Real-World Adoption Examples

Facebook

Created Open Graph Protocol for rich social previews

Twitter (X)

Uses Open Graph data for link preview cards

LinkedIn

Parses Open Graph metadata for shared link previews

Discord

Uses Open Graph data for embedded link previews

Frequently Asked Questions

Automated Generation

Start Using OG.json with Geordy

Geordy automatically generates and maintains OG.json files for your website, ensuring optimal AI visibility without manual work.