> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hadoseo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OG Preview Checker

> Preview how your links appear when shared on social media

## Overview

The **OG Preview Checker** shows you exactly how your links will appear when shared on social media platforms like Twitter/X, Facebook, LinkedIn, and Discord.

<Card title="Try It Free" icon="external-link" href="https://hadoseo.com/free-og-preview-checker">
  Test your site at hadoseo.com/free-og-preview-checker
</Card>

## Why Open Graph Tags Matter

When you share a link on social media, platforms look for Open Graph (OG) tags to create a rich preview. Without them:

* ❌ Links show as plain text URLs
* ❌ No preview image
* ❌ Generic or missing title/description
* ❌ Poor engagement and click-through rates

## How to Use

<Steps>
  <Step title="Enter your URL">
    Paste the URL you want to preview:

    ```
    https://yourdomain.com/page
    ```
  </Step>

  <Step title="Click Check">
    The tool fetches your page and extracts OG tags.
  </Step>

  <Step title="Review Previews">
    See mockups for:

    * Twitter/X
    * Facebook
    * LinkedIn
    * Discord
  </Step>
</Steps>

## Required Open Graph Tags

Add these to every page's `<head>`:

```html theme={null}
<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="A compelling description of this page">
<meta property="og:image" content="https://yourdomain.com/og-image.png">
<meta property="og:url" content="https://yourdomain.com/page">
<meta property="og:type" content="website">
```

## OG Image Guidelines

| Platform  | Recommended Size | Min Size     |
| --------- | ---------------- | ------------ |
| Twitter/X | 1200 x 628 px    | 600 x 314 px |
| Facebook  | 1200 x 630 px    | 600 x 315 px |
| LinkedIn  | 1200 x 627 px    | 552 x 289 px |
| Discord   | 1200 x 630 px    | 256 x 256 px |

### Best Practices

* Use **1200 x 630 pixels** to work on all platforms
* Keep file size under **8MB**
* Use **PNG** or **JPG** format
* Include readable text (but not too much)
* Use absolute URLs (not relative)

## Twitter-Specific Tags

For better Twitter cards:

```html theme={null}
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Page Title">
<meta name="twitter:description" content="Description for Twitter">
<meta name="twitter:image" content="https://yourdomain.com/twitter-image.png">
```

### Card Types

| Type                  | Description                               |
| --------------------- | ----------------------------------------- |
| `summary`             | Small square image with title/description |
| `summary_large_image` | Large horizontal image (recommended)      |

## Implementing OG Tags

### React (React Helmet)

```jsx theme={null}
import { Helmet } from 'react-helmet-async';

function MyPage() {
  return (
    <Helmet>
      <meta property="og:title" content="My Page Title" />
      <meta property="og:description" content="Page description" />
      <meta property="og:image" content="https://mysite.com/og.png" />
      <meta property="og:url" content="https://mysite.com/page" />
      <meta property="og:type" content="website" />
      <meta name="twitter:card" content="summary_large_image" />
    </Helmet>
  );
}
```

### Dynamic OG Images

For unique pages (blog posts, products):

```jsx theme={null}
function BlogPost({ post }) {
  return (
    <Helmet>
      <meta property="og:title" content={post.title} />
      <meta property="og:description" content={post.excerpt} />
      <meta property="og:image" content={post.featuredImage} />
      <meta property="og:url" content={`https://mysite.com/blog/${post.slug}`} />
    </Helmet>
  );
}
```

## Common Issues

<AccordionGroup>
  <Accordion title="Image not showing" icon="circle-exclamation">
    **Causes:**

    * Relative URL instead of absolute
    * Image too small
    * Image URL returns 404
    * Image blocked by robots.txt

    **Fix:** Use absolute URLs starting with `https://` and verify image accessibility.
  </Accordion>

  <Accordion title="Old preview showing" icon="circle-exclamation">
    **Cause:** Platforms cache OG data

    **Fix:** Use platform debuggers to clear cache:

    * [Facebook Debugger](https://developers.facebook.com/tools/debug/)
    * [Twitter Card Validator](https://cards-dev.twitter.com/validator)
    * [LinkedIn Post Inspector](https://www.linkedin.com/post-inspector/)
  </Accordion>

  <Accordion title="Wrong title/description" icon="circle-exclamation">
    **Cause:** OG tags not set or overridden

    **Fix:** Ensure OG tags are in `<head>` and take priority over `<title>`.
  </Accordion>
</AccordionGroup>

## Testing After Changes

1. Update your OG tags
2. Trigger a recrawl in Hado SEO dashboard
3. Clear platform caches using debugger tools
4. Re-test with OG Preview Checker

<CardGroup cols={2}>
  <Card title="Bot Crawler Test" icon="spider" href="/tools/seo-bot-crawler-test">
    Test search engine visibility
  </Card>

  <Card title="Meta Tags Checker" icon="tags" href="/tools/meta-tags-checker">
    Analyze all meta tags
  </Card>
</CardGroup>
