Optimly Connect
Install Optimly on a custom site
Install through a shared layout and the site's normal pull-request workflow.
For React, Next.js, and other code-managed sites, install the generated snippet in the shared HTML document or layout that renders on every measured page.
Git workflow
- Bind the production hostname in Optimly Connect and copy the generated snippet.
- Create a customer-scoped branch in the website repository.
- Add the snippet once to the shared document or layout.
- Update CSP only if required for the Optimly script and collector origins.
- Open a focused pull request and use the site's existing review process.
- Deploy to an authorized test origin when available.
- Verify a test page view before enabling live collection.
- Merge and deploy through the site's normal production workflow.
Single-page applications
The beacon observes supported history navigation so client-side route changes can create page-view events without a full reload. Install one site-wide instance; do not mount a new script element from every route component.
Roll back
Disable the Site Insights site first when collection must stop immediately, then revert the focused installation change and deploy the previous revision.