Sitepress runs on Rails, so most issues and solutions from the Rails troubleshooting guide apply directly.
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.
Make sure you’re editing the correct layout file. Sitepress pages can specify a different layout in their frontmatter.
Wrong variables
Use current_page.data.title for frontmatter values and current_page.request_path for the page path. These are Sitepress-specific helpers.
Wrong image showing
Social platforms and OpenGraph+ cache images. If you’ve updated your page but see the old image:
- Purge the cached image from the OpenGraph+ dashboard
- Wait a few minutes for the new image to render
- Clear the platform’s cache using their debugger tools (see below)
Social platforms not updating
Social networks cache images aggressively. After purging from OpenGraph+, use each platform’s debugger to force a refresh:
- Facebook: Sharing Debugger
- Twitter/X: Card Validator
- LinkedIn: Post Inspector
Purging cached images
- Go to your OpenGraph+ dashboard
- Navigate to the website’s cache page
- Enter the URL and purge
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.