# Chapter 4

## Troubleshooting

### Common issues and solutions

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

1. Purge the cached image from the OpenGraph+ dashboard
2. Wait a few minutes for the new image to render
3. 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](https://developers.facebook.com/tools/debug/)
- **Twitter/X**: [Card Validator](https://cards-dev.twitter.com/validator)
- **LinkedIn**: [Post Inspector](https://www.linkedin.com/post-inspector/)

## Purging

To force OpenGraph+ to re-render an image:

1. Go to your OpenGraph+ dashboard
2. Navigate to the website’s cache page
3. 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.