How to place OptiMonk embedded content on your site

OptiMonk embedded content needs both a compatible installation and a position in your page layout. Installing the script alone does not specify where an embedded campaign should appear.

This guide follows OptiMonk’s embedded-content instructions and JavaScript installation guide, checked September 6, 2026. The test matrix is editorial guidance.

Check installation first

For manual installation, retrieve the account’s code from Settings → Insert code, select the domain and follow the custom-website instructions. OptiMonk specifies the page head and says to include its code once.

The embedded-content guide specifies the Shopify app extension for Shopify. It also identifies WordPress and WooCommerce plugins as suitable existing installations, while describing manual head-code updates for Magento or other platform plugins. Check your actual installation method before adding another copy of the script.

Create and position the campaign

Create a campaign with the Embedded message type, select the domain and edit its design. Continue to placement and choose Point & Click Placement or manual insertion.

With point-and-click placement, select a reference block and place the content above or below it. Confirm the placement, review URL targeting and other conditions, then activate when ready. OptiMonk documents an automatically added current-page rule; additional pages need appropriate URL targeting and the same selector.

Verify the reference block across pages

A position that works on one page may not be a useful position on another. Record the intended page group and the surrounding content rather than relying only on a selector name.

OptiMonk notes that point-and-click placement can fail before cookie consent on sites with restrictive cookie settings. Test the relevant visitor state before diagnosing a selector failure.

Check the campaign’s content limits

The source documents manual product recommendations and fixed coupon codes for embedded content. Confirm your planned offer fits those documented options before designing around automated recommendations or generated codes.

Test behavior before rollout

Verify one eligible page and one excluded page, then inspect the layout after the content loads. If the campaign collects leads, submit a controlled test and trace the contact to its intended destination. Placement success and submission success are separate outcomes.

If content is missing, check installation, campaign status, URL eligibility and the reference block separately. Preserve the existing settings while investigating so each change has an interpretable result.

Record the selected pages and reference position in your handoff notes. Retest after a theme or template change: the original placement decision may no longer match the redesigned page.

For status controls, see activating or pausing an OptiMonk campaign. For comparisons after setup, see OptiMonk variant testing.