📝 WordPress: Fix a Shortcode Rendering Twice Inside the Block Editor
A classic shortcode registered through add_shortcode() can appear to render itself twice inside the Block Editor’s live preview even though the published front end only shows it once, because a page builder panel or preview sidebar that calls do_shortcode($content) on its own copy of the post content runs independently of the core Shortcode block’s own PHP render pass for the same editor session — both execute the shortcode’s callback against the same content, and since the front end’s the_content filter chain only ever runs once per request, the duplication is visible only inside wp-admin and easy to dismiss as a rendering glitch rather than a genuine double execution.
🔎 The Problem
Post content: [booking_widget location="downtown"] Block Editor preview pane: widget renders TWICE, stacked vertically Live front end (same post, published): widget renders ONCE, correctly Plugin's own editor preview panel is independently calling: echo do_shortcode( get_the_content() ); ...while Gutenberg's core/shortcode block ALSO renders the same shortcode through its own REST preview endpoint in the same request
✅ Fix: Make Sure Only One Code Path Renders the Shortcode Per Preview
- Audit any custom meta box, page-builder panel, or admin preview script that calls
do_shortcode()directly on the post content — that’s almost always the second, redundant render path running alongside Gutenberg’s own Shortcode block. - If a custom preview panel genuinely needs its own rendered copy, have it render from a dedicated AJAX endpoint instead of re-running
do_shortcode()against content the Block Editor is already independently previewing in the same screen. - Confirm on the live front end first — if it renders once there, the bug is specifically in an admin-only preview code path, not in the shortcode’s own callback, which saves you from debugging the wrong half of the system.
🚨 Why This Is Dangerous
- Spending hours ‘fixing’ a shortcode’s callback for a duplication bug that only exists in an unrelated admin preview panel, while the actual published page was correct the entire time — and risking breaking the front-end render while chasing a problem that only ever existed in wp-admin.
If it only duplicates in the editor, the bug isn’t in your shortcode — it’s in whatever else is also rendering it.
