JotForm forms

Distro can route a JotForm submission from an accessible form or same-origin iframe. It waits for the iframe to load, checks JotForm validation, and preserves JotForm's native submission handling.

Check your embed

The parent page must be able to access the iframe's form and JotForm API. The iframe must share the parent's origin (scheme, hostname, and port); a sandbox must also permit that access.

A standard cross-origin jotform.com iframe cannot be read by this adapter. Use a JotForm form hosted on your own origin with the JotForm scripts available, or an integration in your application that calls Distro after validation. Merely adding an ID to a cross-origin iframe does not make it accessible.

Connect and install

1. Create a form mapping using the actual field names. Map email and the answers used by your rules.

2. Select it under Form Submission → Connected form in the router.

3. Configure, test, and activate the router.

4. Open Install Router and choose JotForm.

Add the snippet to the parent page. Replace the router ID and iframe selector:

<script src="https://app.distro.so/inbound.js"></script>
<script>
  window.distro = new Distro({
    routerId: "YOUR_ROUTER_ID",
    formType: "jotForm"
  });
  distro.schedule("#jotform-iframe");
</script>

For a form directly on the page, pass that form's CSS selector instead. Both jotForm and jotform are accepted. Distro calls JotForm.validateAll(form) and routes only when it returns true.

Verify

Test invalid answers first: validation should prevent routing. Then submit valid qualified and unqualified answers. Confirm JotForm's normal destination still works, and inspect the expected values in Distro's Routing Logs.

If the form cannot be accessed, Distro emits FORM_UNAVAILABLE through the browser's distro:event event. Check the iframe's origin, sandbox, selector, and JotForm script before retrying.