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 view extends the layout 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 view doesn’t extend layouts.app (or whichever layout has the meta tags)
  2. The @yield('content') or {{ $slot }} section is missing from the layout

Leading slash in path

request()->path() returns the path without a leading slash (e.g., posts/1 not /posts/1). Make sure your meta tag includes the / between the connection URL and the path:

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

{{-- Wrong - missing slash --}}
<meta property="og:image" content="https://$OGPLUS_KEY.ogplus.net{{ request()->path() }}">

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.