WordPress integration

Embed OmniLab campaigns in WordPress with a Custom HTML block, iframe, or reusable JavaScript tag.

2 min read

Embed an OmniLab campaign in a WordPress page so visitors interact with it without leaving your site. This page is for your site admin or web team.

WordPress hosts OmniLab the same way as any other website: there is no dedicated OmniLab plugin to install. You paste a manual iframe or a reusable JavaScript tag into a Custom HTML block, the same as you would on any other page builder.

Choose the WordPress path

OptionBest whenTypical owner
Custom HTML + manual iframeYou already know the exact OmniLab URL to loadMarketer or site admin
Custom HTML + JavaScript tagOne WordPress page should load different campaigns based on the page URLSite admin or developer

Manual iframe in WordPress

Copy the final OmniLab URL

Choose the landing page or direct touchpoint URL you want to embed, then append embedded=1.

Insert a Custom HTML block

In the WordPress editor, add a Custom HTML block or another code-capable area that accepts raw iframe markup.

WordPress block editor showing the Custom HTML block being added

Paste the iframe snippet

Paste the iframe embed code into the Custom HTML block. Your developer or OmniLab Customer Success Manager can provide the exact snippet for your environment. The code loads your OmniLab campaign URL inside the page with the correct size and permissions.

Need the exact embed code?

The full embed snippet with technical parameters is in Iframe embedding (developers). Share that page with your developer if needed.

Preview the real front-end page

Preview the WordPress page in the front-end experience, not only in the editor, so you can verify the final layout and permissions.

Reusable JavaScript tag in WordPress

If the same WordPress page should load different campaigns based on the current URL, your developer can place an OmniLab player tag in a Custom HTML block, theme template, or another approved code-injection area.

This approach lets a single WordPress page — for example /promo — display different campaigns depending on which URL the visitor arrives from. Your developer or OmniLab Customer Success Manager can provide the player tag snippet and walk you through the URL pattern.

Need the technical details?

The full player tag configuration is in Iframe embedding (developers).

Publish checklist

  • Test desktop and mobile layouts from the published page.
  • Verify camera, microphone, or geolocation permissions if the experience needs them.
  • Check cookies, sign-in flows, and redirects inside the real WordPress page.
  • If the page is cached by WordPress or a CDN, clear the cache after you update the embed code.

If visitors should stay signed in to the embedded experience

Carrying a visitor's existing WordPress sign-in into the embedded OmniLab campaign is a separate, developer-led identity integration, not something the iframe or JavaScript tag does on its own. See Customer accounts if you want returning participants recognised automatically.

On this page