Chapter 4

Troubleshooting

Common issues and solutions

Meta tags not appearing

Check that the meta tags are in your layout’s <head>. View the page source (not browser DevTools) to confirm the tags are present in the raw HTML.

If you use multiple layouts, add the meta tags to each one or use a shared include:

<head>
  {% include ogplus.html %}
</head>

Wrong image showing

Social platforms and OpenGraph+ cache images. If you’ve updated your page but see the old image:

  1. Purge the cached image from the OpenGraph+ dashboard
  2. Wait a few minutes for the new image to render
  3. Clear the platform’s cache using their debugger tools (see below)

Liquid syntax

Jekyll uses Liquid ({{ }}). The connection URL is a plain string, so there are no syntax conflicts with https://$OGPLUS_KEY.ogplus.net.

If you’re generating og:plus:cache:etag dynamically with Liquid variables, make sure the variable resolves correctly:

<meta property="og:plus:cache:etag" content="{{ page.last_modified_at | date: '%s' }}">

Social platforms not updating

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

Purging

To force OpenGraph+ to re-render an image:

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

Testing

Use the preview tool in your OpenGraph+ dashboard to test how any page on your site renders as a social card. Paste a URL and see the result immediately.