# Chapter 3

## Troubleshooting

### Common issues and solutions

## Meta tags not in page source

View your page source, not DevTools. Meta tags must be in the initial HTML response, not injected by JavaScript. Social crawlers only see server-rendered HTML.

## Wrong path in og:image URL

The path must match the actual page URL. If your page is at `yoursite.com/blog/my-post`, the og:image URL should be `https://$OGPLUS_KEY.ogplus.net/blog/my-post`.

For dynamic sites, ensure your server-side code outputs the correct path. Hardcoded paths are the most common source of mismatches.

## Wrong image showing

This is almost always a caching issue. Purge the cached image from the OpenGraph+ dashboard, then re-check with the preview tool.

## JavaScript-rendered content

OpenGraph+ renders your page with a browser, so JavaScript content is captured in the social card image. But the `og:image` meta tag itself must be in the initial HTML for social platforms to read it. Social crawlers do not execute JavaScript.

## Social platforms not updating

Social networks cache images aggressively. After purging from OpenGraph+, use each platform’s debugger to force a refresh:

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

## Purging cached images

1. Go to your OpenGraph+ dashboard  
2. Navigate to the website’s cache page  
3. Enter the URL and purge

The next request from a social platform will trigger a fresh render.

## Testing

Use the preview tool in your OpenGraph+ dashboard to verify your setup before sharing URLs. This shows you exactly what social platforms will see.

## Need a specific framework guide?

Check our framework-specific guides for detailed integration instructions for [Next.js](/content/docs/nextjs/index.html), [Nuxt](/content/docs/nuxt/index.html), [Astro](/content/docs/astro/index.html), [Django](/content/docs/django/index.html), [Laravel](/content/docs/laravel/index.html), [Jekyll](/content/docs/jekyll/index.html), [Middleman](/content/docs/middleman/index.html), [WordPress](/content/docs/wordpress/index.html), [Shopify](/content/docs/shopify/index.html), [Webflow](/content/docs/webflow/index.html), [Wix](/content/docs/wix/index.html), [Rails](/content/docs/rails/index.html), or [Sitepress](/content/docs/sitepress/index.html).