Embedding a guide

Once you’ve built a guide in the Guide Editor, you need to embed it on a page for your visitors to use. GuideForms offers two embedding methods: the Gutenberg block and a shortcode. Both produce the same result on the frontend.

Using the Gutenberg block

This is the recommended way to embed a guide if you’re using the WordPress block editor:

  1. Edit the page or post where you want the guide to appear.
  2. Click the + block inserter (or type / in an empty block).
  3. Search for “GuideForms”.
  4. Insert the GuideForms Guide block.
  5. In the block settings, select your guide from the dropdown list.
  6. Publish or update the page.

The block shows a live preview in the editor so you can see which guide is selected. You can also add a custom CSS class via the block’s Advanced settings panel if you need to target it with custom styles.

Using the shortcode

If you prefer shortcodes or are using the Classic Editor, embed a guide with:

[guide id="123"]

Replace 123 with your guide’s post ID.

Finding the guide ID

You can find the ID in two places:

  • All Guides list — Go to GuideForms → All Guides. The ID is shown in the guide list table.
  • Guide Editor URL — When editing a guide, the URL contains the ID: admin.php?page=guideforms-editor&id=123.

Adding a custom CSS class

Use the optional class attribute to add one or more CSS classes to the guide container:

[guide id="123" class="my-custom-class"]

This is useful for applying page-specific styles without affecting other guides on your site.

Where you can embed

Guides work anywhere the block editor or shortcodes are supported:

  • Pages
  • Posts
  • Custom post types
  • Widget areas (using a Shortcode widget)
  • Page builder modules that support shortcodes

Multiple guides on one page

You can embed more than one guide on the same page. Each guide operates independently — with its own steps, filters, sessions, and results. Simply add multiple blocks or shortcodes, each pointing to a different guide ID.

Embedding the same guide ID twice on one page is not supported and may cause unexpected behavior.

Next steps

Now that your guide is live on a page, explore what else you can do: