Troubleshooting Nuxt OG Image · Nuxt OG Image · Nuxt SEO [NuxtSEO](https://nuxtseo.com/ "Home") - [Modules](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction) - [Tools](https://nuxtseo.com/tools) - [Pro](https://nuxtseo.com/pro) - [Learn SEO](https://nuxtseo.com/learn-seo/nuxt) [Releases](https://nuxtseo.com/releases) [1.4K](https://github.com/harlan-zw/nuxt-seo) [Nuxt SEO on GitHub](https://github.com/harlan-zw/nuxt-seo) **OG Image v6** is here! Looking for an older version? [View v5 docs](https://nuxtseo.com/docs/og-image/v5/getting-started/introduction). [User Guides](https://nuxtseo.com/docs/og-image/getting-started/introduction) [API](https://nuxtseo.com/docs/og-image/api/define-og-image) [Releases](https://nuxtseo.com/docs/og-image/releases/v6) OG Image - [Switch to OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction) - [Switch to Nuxt SEO](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction) - [Switch to Robots](https://nuxtseo.com/docs/robots/getting-started/introduction) - [Switch to Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction) - [Switch to Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction) - [Switch to Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction) - [Switch to SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction) - [Switch to Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction) - [Switch to Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction) - [Switch to AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction) Search…```k`` /` v6 (latest) - Playgrounds - [Discord Support](https://discord.com/invite/275MBUBvgP) ### Getting Started - [Introduction](https://nuxtseo.com/docs/og-image/getting-started/introduction) - [Installation](https://nuxtseo.com/docs/og-image/getting-started/installation) - [Troubleshooting](https://nuxtseo.com/docs/og-image/getting-started/troubleshooting) - [Tutorial: Your first OG Image](https://nuxtseo.com/docs/og-image/getting-started/getting-familiar-with-nuxt-og-image) ### Core Concepts - [Zero Runtime](https://nuxtseo.com/docs/og-image/guides/zero-runtime) - [WhatsApp & Multiple Images](https://nuxtseo.com/docs/og-image/guides/whatsapp) - [Performance](https://nuxtseo.com/docs/og-image/guides/performance) - [CLI](https://nuxtseo.com/docs/og-image/guides/cli) - [Security](https://nuxtseo.com/docs/og-image/guides/security) - [Cloudflare](https://nuxtseo.com/docs/og-image/guides/cloudflare) - [Route Rules](https://nuxtseo.com/docs/og-image/guides/route-rules) - [Caching Images](https://nuxtseo.com/docs/og-image/guides/cache) - [JPEGs](https://nuxtseo.com/docs/og-image/guides/jpegs) - [Custom Fonts](https://nuxtseo.com/docs/og-image/guides/custom-fonts) - [Non-English Locales](https://nuxtseo.com/docs/og-image/guides/non-english-locales) - [Emojis](https://nuxtseo.com/docs/og-image/guides/emojis) - [Icons and Images](https://nuxtseo.com/docs/og-image/guides/icons-and-images) - [Styling](https://nuxtseo.com/docs/og-image/guides/styling) - [Community Templates](https://nuxtseo.com/docs/og-image/guides/community-templates) - [Error pages](https://nuxtseo.com/docs/og-image/guides/error-pages) ### Overview - [Overview](https://nuxtseo.com/docs/og-image/renderers) - [Takumi Renderer](https://nuxtseo.com/docs/og-image/renderers/takumi) - [Satori Renderer](https://nuxtseo.com/docs/og-image/renderers/satori) - [Browser Renderer](https://nuxtseo.com/docs/og-image/renderers/browser) ### Integrations - [Nuxt Content](https://nuxtseo.com/docs/og-image/integrations/content) - [Nuxt Color Mode](https://nuxtseo.com/docs/og-image/integrations/color-mode) - [Nuxt I18n](https://nuxtseo.com/docs/og-image/integrations/i18n) Getting Started # Troubleshooting Nuxt OG Image [Copy for LLMs](https://nuxtseo.com/docs/og-image/getting-started/troubleshooting.md) ## [Debugging](#debugging) ### [Nuxt DevTools](#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](#debug-config) You can enable the [debug](https://nuxtseo.com/docs/og-image/api/config#debug) option which will give you more granular output. ### [Text Missing on Cloudflare Workers](#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](https://nuxtseo.com/docs/og-image/guides/cloudflare) for the fix. ### [Long OG Image URLs](#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](https://nuxtseo.com/docs/og-image/guides/performance) guide for strategies to reduce URL size and optimise rendering. ## [Submitting an Issue](#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-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 - `