Skip to main content

​
Install Trfyx on Webflow

Add Trfyx to your Webflow site using Site settings → Custom Code. This installs the tracker site-wide so your published pages can send analytics data to your Trfyx project.
Before you start: Make sure you have access to your Webflow site’s Custom Code settings and have a Trfyx project ready in app.trfyx.com.

​
Add the tracker

1

Open Site Settings

In your Webflow dashboard, select the site you want to track and open Site settings.
2

Open Custom Code

Open the Custom Code tab and find the Head Code section. Site-wide head code is added to the <head> of your published pages.
3

Add the Trfyx snippet

Paste the following snippet into Head Code:
Replace YOUR_TRFYX_PROJECT_ID with the project identifier from your Trfyx workspace and yourdomain.com with the domain you are tracking. Do not copy these placeholder values into production.
Keep the tracker in Webflow’s site-wide Head Code when you want Trfyx on the entire website. You do not need to paste the snippet separately into every page.
4

Save and publish

Click Save changes, then publish your Webflow site. Custom code may appear while testing in Webflow, but the changes are not live until the site is published.

​
Verify installation

After publishing, verify the live website rather than relying only on the Webflow Designer.
  1. Open your published domain in a new browser tab.
  2. Visit a few pages and navigate between them.
  3. Open app.trfyx.com and select the Trfyx project connected to that domain.
  4. Confirm that new activity is appearing for the correct project and hostname.
If you test using Webflow Preview, make sure custom code is enabled. For the final verification, use the published site because Webflow custom-code changes do not become live until publication.

​
Troubleshooting

Confirm that you replaced both placeholders with the correct Trfyx project ID and domain. Then make sure the Webflow site was published after saving the custom code.
Open your browser’s Developer Tools and check the Console and Network tabs for blocked requests or Content Security Policy errors. Also confirm that the snippet contains both the opening and closing <script> tags.
Check whether Trfyx has also been installed through Google Tag Manager, another Webflow integration, or custom code on individual pages. Keep one tracker installation for the same site unless you intentionally handle duplicate collection.
No. Use Webflow’s site-wide Head Code section when you want Trfyx across the entire site. Use page-level custom code only when you intentionally want tracking on specific pages.

​
Important Webflow notes

Do not paste <html>, <body>, or <head> tags into Webflow’s Custom Code fields. Webflow’s documentation warns that these tags can break the site’s layout.
Webflow recommends using async or defer for external scripts placed in the head when appropriate. The Trfyx snippet already uses defer so the browser can continue parsing the page while the tracker loads.
If your site uses a strict Content Security Policy (CSP) or a consent-management platform, make sure your configuration allows the Trfyx script and analytics requests required by your setup.

​
Next steps

Once installation is verified, continue with:
  • Quickstart — Set up your first Trfyx analytics workflow.
  • Goals — Define important user actions and conversions.
  • Funnels — Understand where users convert or drop off.
  • Troubleshooting — Diagnose missing or unexpected data.
Last modified on October 11, 2026