Chapter 3

Troubleshooting

Common issues and solutions

Something not working? Here are the most common issues and how to fix them.

Meta tags not appearing

Make sure you edited the correct header.php. If you’re using a page builder or Full Site Editor, the theme may not use header.php at all. In that case, add meta tags via a plugin or the theme’s custom code section instead.

Check: View your page source, not DevTools. Page source shows what crawlers see.

Duplicate og:image tags

SEO plugins like Yoast, RankMath, and All in One SEO set their own og:image tags. Disable the social image feature in those plugins, or use the plugin’s API to override with the OpenGraph+ URL.

Wrong image showing

This is almost always a caching issue. WordPress caching plugins cache the HTML output.

  1. Purge your WordPress cache first
  2. Open the preview tool in your OpenGraph+ dashboard
  3. If the image is still stale, purge it from the dashboard
  4. Re-check with the preview tool

PHP errors

Ensure <?= ?> short tags are enabled (they are by default in PHP 5.4+). If you see raw <?= $_SERVER['REQUEST_URI'] ?> in your page source, use the long form instead:

<meta property="og:image" content="https://$OGPLUS_KEY.ogplus.net<?php echo $_SERVER['REQUEST_URI']; ?>">

Social platforms not updating

Twitter, LinkedIn, and Slack cache images aggressively on their end. After confirming the correct image appears in the OpenGraph+ preview tool:

This is platform-side caching that OpenGraph+ cannot control.

Purging cached images

  1. Go to your website dashboard in OpenGraph+
  2. Find the page you want to refresh
  3. Click purge to clear the cached image

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.