Nuxt Studio "init the preview" Content is missing
The content of my webpage disappears after “init the preview.”
It was visible before initializing the preview.


3 Replies
Hi @dayo_Li. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:
----------------------
When you "init the preview" in Nuxt Studio and your content disappears, this is typically related to the new Preview API integration in Nuxt Content v3. Here are the key points and troubleshooting steps based on the knowledge sources:
1. Preview API Setup
With Nuxt Content v3, the Studio module is deprecated. Instead, you must enable the Preview API in your
If you recently migrated to Content v3, ensure you are using the new APIs and components. For example,
Components in
If you want to keep your app config file updatable from Studio, update the helper import in
Nuxt provides a
If your content disappears after initializing preview in Nuxt Studio, double-check your
- Preview API Configuration - Migration Guide: Components and Studio Integration - usePreviewMode Composable ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
With Nuxt Content v3, the Studio module is deprecated. Instead, you must enable the Preview API in your
nuxt.config.ts:
This is required for live preview in Nuxt Studio. If this is missing or misconfigured, preview mode may not work as expected and could result in missing content after initializing preview mode Docs: Preview API.
2. Component and API ChangesIf you recently migrated to Content v3, ensure you are using the new APIs and components. For example,
<ContentRenderer> replaces older components like <ContentDoc>, <ContentList>, etc. Using deprecated components or APIs can cause content not to render, especially in preview mode Migration Guide.
3. Manual Component RegistrationComponents in
components/content are no longer auto-registered globally. If you use dynamic rendering or custom components, you must register them manually. Failing to do so can result in missing content, particularly when the preview mode tries to render those components Migration Guide.
4. App Config FileIf you want to keep your app config file updatable from Studio, update the helper import in
nuxt.schema.ts from @nuxthq/studio/theme to @nuxt/content/preview Migration Guide.
5. Preview Mode ComposableNuxt provides a
usePreviewMode composable to check and control preview state. If you have custom logic that depends on preview mode, ensure you are using this composable correctly. Preview mode is enabled via a URL query parameter (?preview=true) and can affect how data is fetched and displayed usePreviewMode docs.
Summary:If your content disappears after initializing preview in Nuxt Studio, double-check your
nuxt.config.ts for the correct Preview API setup, ensure you are using the new Content v3 components and APIs, and verify that all custom components are properly registered. If these steps are followed and the issue persists, there may be a misconfiguration or a bug, but the knowledge sources do not provide further troubleshooting steps for this specific scenario.
If you need more detailed debugging, please provide your configuration and component usage for further assistance.
References:- Preview API Configuration - Migration Guide: Components and Studio Integration - usePreviewMode Composable ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
<@1410870997061603339> Kapa.ai is still learning and improving, please let me know how I did by reacting below.
为什么在 nuxt studio 中我的yml 文件中的内容消失了?