Meta tags not appearing
Check that the meta tags are in the <head> of your layout file. View the page source (not browser DevTools) to confirm the tags are present in the raw HTML.
If you’re using multiple layouts, make sure the og:image and twitter:card meta tags are included in each one.
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)
Client-side islands
Astro components render as static HTML by default, which is ideal for social cards. Interactive islands (client:load, client:visible, etc.) execute JavaScript after the initial HTML loads.
OpenGraph+ captures the initial HTML, so content inside interactive islands may not appear in your social card. Keep important social card content outside of client-side islands, or ensure it’s included in the server-rendered HTML.
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
To force OpenGraph+ to re-render an image:
- Go to your OpenGraph+ dashboard
- Navigate to the website’s cache page
- 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.