Skip to main content
Framer is the guide where AgentRef differs most clearly from other affiliate tools: you only need the main tracking script. AgentRef already handles late-rendered Stripe links, Buy Buttons, and Pricing Tables by itself.

​
Before you start

  • Set the program website in AgentRef to the same root domain as your Framer site.
  • Copy the exact script snippet from Settings -> Integration.
  • Decide whether you use Stripe-hosted surfaces or a custom checkout flow.

​
Install the script in Framer

  1. Open your Framer project.
  2. Go to Site Settings -> General -> Custom Code.
  3. Paste the AgentRef script into the End of <head> field.
  1. Publish the site.

​
What makes AgentRef different on Framer

Other tools often need extra body scripts in Framer to rewrite Stripe links after the page renders. AgentRef already does that internally. That means:
  • no separate Stripe Payment Link enhancer script
  • no separate Pricing Table enhancer script
  • no separate Buy Button enhancer script
As long as the AgentRef script is loaded on the page, it will observe the DOM and instrument supported Stripe-hosted surfaces automatically.

​
Checkout compatibility on Framer

  • If Framer is just the marketing layer and checkout begins on app.example.com, install AgentRef on both surfaces.
  • Different root domains do not share first-party cookies automatically.
  • If you use a consent manager, call window.AgentRef.setConsent('granted') after opt-in.

​
Verify the installation

1

Publish the Framer site

Framer custom code only matters on the published site.
2

Run a real referral visit

Open a live affiliate link and confirm agentref_cid and agentref_pid.
3

Check hosted Stripe instrumentation

If the page contains Stripe links or elements, use ?agentref_debug=1 and inspect the console or DOM.
4

Validate the checkout path

If you create custom Checkout Sessions elsewhere, follow the Stripe guide.

​
Troubleshooting

  • Payment Links are still plain after publish: confirm the AgentRef script actually loads on the same page as the links.
  • The Framer page records clicks but conversions never appear: your checkout path is probably outside Framer and still needs the Stripe metadata bridge.
  • Cookies do not survive from Framer to the app: keep both on one root domain and install AgentRef on both.

Stripe Checkout

Use this if Framer hands off into your own Stripe session-creation backend.

Debug Mode

Inspect hosted Stripe instrumentation and runtime warnings.

JavaScript Snippet

Full script behavior and DOM API reference.