Chapter 4

Troubleshooting

Common issues and solutions

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

Meta tags not appearing

Check that your template extends the base template that has the meta tags. View your page source to verify the og:image and twitter:card tags are present in the <head>.

Common causes:

  1. Your template doesn’t extend base.html (or whichever template has the meta tags)
  2. The request variable isn’t available in the template context

request.path not available

request.path requires the django.template.context_processors.request context processor. This is enabled by default in new Django projects, but may be missing in older ones.

Add it to your TEMPLATES setting:

# settings.py
TEMPLATES = [
    {
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.request',
                # ... other processors
            ],
        },
    },
]

Wrong image showing

This is almost always a caching issue. Social platforms and OpenGraph+ both cache images.

  1. Open the preview tool in your OpenGraph+ dashboard
  2. Paste your URL to see what OpenGraph+ currently has
  3. If the image is stale, purge it from the dashboard
  4. Re-check with the preview tool

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.