This guide covers common issues specific to Storyblok-powered websites. Since Storyblok is a visual headless CMS, issues often relate to the Visual Editor bridge and frontend framework integration.
Common Issue Categories
Performance Issues
- Visual Editor loading speed
- Bridge mode overhead
- Image optimization with Storyblok assets
- Component render performance
Tracking Issues
- Analytics firing in Visual Editor
- Block-level tracking not working
- Story UUID vs slug tracking inconsistency
- Real-time preview event duplication
Quick Diagnostics
Visual Editor Detection
// Check if in Visual Editor
const isEditor = typeof window !== 'undefined' && (
window.location.search.includes('_storyblok') ||
window.StoryblokBridge !== undefined
);
console.log('In Visual Editor:', isEditor);
Bridge Mode Issues
// Debug bridge connection
if (window.StoryblokBridge) {
window.StoryblokBridge.on('change', (event) => {
console.log('Bridge event:', event);
});
}
Related Global Guides
For platform-agnostic troubleshooting, see: