# 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 added the tags to `layout/theme.liquid`, not just a section or template. `theme.liquid` is the master layout that wraps every page.

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

## Duplicate og:image tags

Shopify themes include social meta tags by default. Search your theme files for `og:image` — especially `snippets/social-meta-tags.liquid` and `snippets/meta-tags.liquid` — and remove or comment out the existing tags.

## Wrong image showing

This is almost always a caching issue. Shopify’s CDN caches pages.

1. Wait a few minutes after making theme changes
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

## Liquid syntax

`{{ request.path }}` is a Shopify Liquid object. Don’t wrap it in quotes or escape it. If the output looks wrong, check that you’re using `request.path` (not `request.url` which includes the full domain).

The meta tag should look like this in your template:

```
<meta property="og:image" content="https://$OGPLUS_KEY.ogplus.net{{ request.path }}">
```

## 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:

- **Twitter:** Use the [Card Validator](https://cards-dev.twitter.com/validator) to force a refresh
- **LinkedIn:** Use the [Post Inspector](https://www.linkedin.com/post-inspector/) to clear their cache
- **Facebook:** Use the [Sharing Debugger](https://developers.facebook.com/tools/debug/) to scrape again

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.