---
title: "Troubleshooting Nuxt OG Image"
description: "Create minimal reproductions for Nuxt OG Image or just experiment with the module."
canonical_url: "https://nuxtseo.com/docs/og-image/getting-started/troubleshooting"
last_updated: "2026-05-10T18:26:45.459Z"
---

## Debugging

### Nuxt DevTools

The best tool for debugging is the Nuxt DevTools integration with Nuxt OG Image.

This will show you your OG Image and give you all of the debug information.

### Debug Config

You can enable the [debug](/docs/og-image/api/config#debug) option which will give you more granular output.

### Text Missing on Cloudflare Workers

If your OG images render the background and images but all text is invisible, the [Cloudflare](https://cloudflare.com) `ASSETS` binding is not configured. Without it, the worker cannot load font files at runtime.

See the [Cloudflare deployment guide](/docs/og-image/guides/cloudflare) for the fix.

### Long OG Image URLs

If your runtime OG image URLs are long (500+ characters), v6 expects this - it encodes all options directly in the URL path for stateless CDN caching. See the [Performance](/docs/og-image/guides/performance) guide for strategies to reduce URL size and optimise rendering.

## Submitting an Issue

You can use the following StackBlitz playgrounds to experiment with Nuxt OG Image and submit issues.

If you run into any issues with Nuxt OG Image, it's recommended to clone of these playgrounds StackBlitz
to reproduce the issue.

- [Satori (custom template)](https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/basic-satori)
- [Takumi (custom template)](https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/basic-takumi)
- [Nuxt Content](https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/content)
- [Nuxt I18n](https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/i18n)

### StackBlitz Compatibility

[StackBlitz](https://stackblitz.com) runs Nuxt within a webcontainer, so it has limited compatibility.

- You can't use anything that will require a fetch request to a different server (e.g. Google Fonts, custom Emojis, images, etc).
- The `browser` renderer is not supported
- `sharp` is not supported, so you can't use JPEGs
- `<style>` blocks may have limited support

## Debugging Tools

- [Social Share Debugger](/tools/social-share-debugger) - Preview OG images across Twitter, Facebook, LinkedIn, Slack and Discord. Clear platform caches instantly.