Before you start
- Set the program website in AgentRef to the same root domain your Webflow site uses.
- Copy the exact script snippet from
Settings -> Integration. - If your app or checkout starts on another subdomain, install AgentRef there too.
Install the script site-wide
- Open your Webflow project.
- Go to
Site Settings -> Custom Code. - Paste the AgentRef script into the
Head Codefield.
- Save the change.
- Publish the site.
Webflow custom code only runs on the published site, not in the Designer preview.
Checkout compatibility on Webflow
| Flow | Status with AgentRef |
|---|---|
| Stripe Payment Links, Buy Buttons, or Pricing Tables embedded on Webflow pages | Supported directly. |
| Custom Stripe checkout you own outside Webflow Ecommerce | Supported with the Stripe guide. |
| Webflow Ecommerce native checkout | Not an automatic AgentRef attribution surface today. |
Multi-domain and consent notes
- Webflow marketing site plus app subdomain is fine if both live under one root and both install AgentRef where needed.
- Different root domains do not share first-party cookies automatically.
- If you gate cookies behind consent, call
window.AgentRef.setConsent('granted')after opt-in.
Verify the installation
- Publish the site.
- Open a real affiliate link to the live Webflow domain.
- Confirm
agentref_cidandagentref_pidexist in browser cookies. - Add
?agentref_debug=1and inspect the console. - If you use custom Stripe checkout, validate the Stripe guide end-to-end.
Troubleshooting
- The script works in code settings but not live: republish the site after saving.
- The script exists but clicks are not verified: confirm the program website in AgentRef matches the Webflow domain.
- Conversions are missing while clicks arrive: you are either using Webflow Ecommerce native checkout or your custom Stripe path still needs the metadata bridge.
Related docs
Stripe Checkout
Required for custom Webflow-to-Stripe checkout paths.
Debug Mode
Inspect hosted Stripe instrumentation and runtime warnings.
Consent and GDPR
Coordinate AgentRef with your consent manager.