Use POM shortcodes in Gutenberg

Use the POM Shortcode block when a page in the WordPress block editor needs an existing POM module, such as a configured listing or faceted search controls. This guide is for page editors with a working shortcode and permission to edit the page. The module must be enabled and configured on the site.

Add the module

1. Open Pages → All Pages and edit the page in the block editor.
2. Open the block inserter and search for POM Shortcode. Insert it where the module should appear, normally inside the relevant POM layout column.
3. Paste the complete shortcode source into POM shortcode source, including any matching closing tags. Keep the existing shortcode name and its configured IDs.
4. Save the draft or save your changes, then preview the page. The editor displays editable source; the frontend displays the module output.
5. Reopen the page and confirm that the source is retained. Review its output at desktop and phone widths.

The block preserves shortcode source without adding a frontend wrapper. Rendering, query results and conditional assets continue to use the existing WordPress and POM shortcode systems. A listing still requires a saved query and a feed layout; adding this block does not create those settings.

Resolve missing output

• If the block is absent, check that POM Theme is active, the installed version includes POM Shortcode and the editor permits it for this page.
• If literal shortcode text appears in the preview, check the shortcode name and whether its module is enabled.
• If a listing is empty, inspect its configured query, content publication state and filters. Retaining source does not prove that a query has results.
• Keep interactive modules out of Paragraph blocks: a Paragraph is for text, while POM Shortcode preserves the module source.

See Save, update, preview, and publish and Troubleshoot the published page.