Back to help center

Getting started & installation

Install Onvocado on a single-page website

Install once and test client-side route changes, page rules and submissions.

1 min read Reviewed Nov 10, 2026

01 Follow these steps

  1. Copy the website’s current snippet from Website settings → Installation.
  2. Add it once in the shared document or site-wide layout, rather than mounting a fresh script in every route component.
  3. Publish the site and open an eligible route directly. Then navigate to another route through the app without a full reload.
  4. Test included and excluded path rules after both navigation types. Onvocado observes History API changes and popstate; if your custom router needs an explicit page notification, use the supported page command.

02 Optional page notification

window.onvocado?.push({ type: "page" });

Call this after the new page content and URL are ready. Do not replace the website snippet with this command, and do not repeatedly initialize the SDK.

03 Check the result

Complete a valid signup after a client-side navigation and find it in Leads. Check that the recorded page path is the expected route. Use display limits and troubleshooting if an earlier display or dismissal prevents a repeat test.

04 What the current app looks like

The actual SDK displaying the published design on the fictional test shop.
The actual SDK displaying the published design on the fictional test shop.

Was this article helpful?

Related articles

Didn't find what you need?

Our team is one message away. Expect a reply within a business day.

Contact support