How to use Octanist when your form is in an iframe
Some websites embed a form from another tool. That embed is usually an iframe.
The Octanist pixel on your page can still track the visit. It cannot see the form inside the iframe.
That is expected. The form lives in another document, so the pixel on the parent page cannot read the submitted fields.
Keep the pixel on your page
Install the pixel on the parent page anyway. That is how Octanist creates the session and stores attribution such as UTMs and click IDs.
The missing piece is only the form submission. You need another way to send that lead to Octanist.
Three ways to send the lead
1. You control the iframe page
If the form is hosted on a page you own, install the pixel there as well. Then Octanist can capture the form inside that page.
2. The form tool can send a webhook
Keep the pixel on the parent page. When the form is submitted, send the lead from your server with server-side form capture. Include the octa_sid session ID from the parent page so Octanist can link the lead to the original visit.
3. The iframe can talk to the parent page
If the form can postMessage the submitted fields back to your page, call window.OCT.submitLeadForm(...) with the client-side API.
What does not work
Do not expect data-forms="true" on the parent page to capture an iframe form. The same applies to the WordPress plugin: it cannot hook into a form that runs in another document / web page.
When to contact support
Iframe forms are not supported out of the box. If the form provider cannot send a webhook, a redirect, or postMessage data back to your page, contact support and we can look at a custom setup.
