For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/guides/external-pages-with-clickmax.md.
  • English

      • How do I use Clickmax with a page hosted elsewhere?

      You do not have to rebuild a site that already works. A page hosted somewhere else can feed Clickmax with leads, events and navigation — as long as it loads the tracking code.

      Before you start

      • Role: Owner, Admin or Editor.
      • You need access to the external page's HTML to add the script.

      1. Choose the route

      What you wantUse
      Just to receive the leads from an existing formCapture link
      To track navigation and events beyond the formBrowser SDK on the page
      To send the visitor on to the next step of the funnelBrowser SDK with routing
      To sell on the external page itselfCheckout on a page hosted elsewhere

      2. Capture the form

      With the script on the page, your form's fields start feeding Contacts. The contact enters your base like any other and can trigger automations.

      3. Record the source

      The external page also has to carry the UTMs through to the capture, otherwise the lead arrives with no source. See UTMs and lead source.

      4. Mark the elements that advance the funnel

      An ordinary button or link is not recognised on its own. For it to fire the next step, add the Clickmax class or attribute to what is already there — without removing anything:

      <button class="your-button cm-checkout-button">Buy now</button>
<a href="#" class="your-link cm-next-funnel-node">Continue</a>
<form data-cx-ingest-form>...</form>

      The full list is in Tracking.

      5. Scan the page from the funnel

      On the external page's card inside the funnel, use Scan triggers. The page opens in a new tab and reports, in that same tab, how many elements were found and how many are ready to become a trigger. Then just close the tab and go back to the funnel.

      The scan waits for the page to finish rendering before reading the elements, so pages that build their content with JavaScript work too — it can take a few seconds.

      Only the elements you marked in the previous step become available as triggers. The rest show up in the funnel as detected without annotation, so you know what is still missing.

      6. Send them on to the next step

      If the external page is the front door to a Clickmax funnel, routing takes the visitor to the next step while keeping the context — rather than a fixed link that loses the trail.

      7. Validate

      Capture a test lead and confirm it appears in Contacts with the right source. See also validate pixel and events.

      The technical installation details are in the reference (Portuguese).

      If it didn't work

      • The lead does not arrive: confirm the script loads on the page — test with the browser console open.
      • It arrives with no source: the UTMs are not being carried through the navigation.
      • The form is not recognised: review how the fields are marked up, following the reference (Portuguese).
      • The scan says it found no elements: the page had not finished loading, or the script is not on it. Reload and scan again.
      • The scan found elements but no click trigger shows up in the funnel: the elements are there but not marked — go back to step 4.
      • The scan says the link expired: go back to the funnel and click Scan triggers again; the link is short-lived.