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

      If your site is built with AI (Lovable, Bolt, v0)

      On the external page card, open Configure external page, pick With AI (Lovable, Bolt, v0) and click Copy full prompt. The prompt is built from the step's data: the <head> script, every button linked to a trigger with its destination and, on checkout, upsell and downsell pages, the checkout and the decline link. Pick PT or EN, paste it into the site builder and check the element list it returns at the end.

      Connect the triggers in the funnel before copying: the prompt only mentions buttons already linked to a step. After publishing, click I pasted and published it and then Check now.

      How to tell whether the page is set up

      The last step of Configure external page, All set?, shows each item as Ready or Pending: the <head> script, buttons that move the funnel forward, embedded checkout and declining the offer (the last two only on checkout, upsell and downsell pages). The status comes from the last scan and the card's triggers. On a pending item, Fix opens the step that fixes it. When everything is ready, the window opens straight on this summary.

      In the Buttons that move the funnel forward step, each button linked to a trigger shows its state: Marked, Missing id (the button has no id, so the click is not recognized), Not marked (the Clickmax marking is missing) or Not found (the last scan did not find the button on the page).

      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.

      Do not point these buttons at the offer's payment link (payments.clickmax.io/...) or at another platform's checkout. The buyer pays outside the funnel and never reaches the next step. Use the next step's address or #; Clickmax handles the routing. The scan flags links like this in the funnel diagnostics.

      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.