Skip to main content
Wix works well for AgentRef as a marketing site or a page that hosts supported Stripe elements. Like several builders, it becomes a different conversation once Wix owns the actual checkout path.

Before you start

  • Set the program website in AgentRef to the same root domain your Wix 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 through Wix custom code

  1. Open the Wix Editor for your site.
  2. Go to Settings -> Custom Code.
  3. Click Add Custom Code.
  4. Choose All Pages.
  5. Choose placement in Head.
  6. Paste the AgentRef script:
<script
  defer
  src="https://www.agentref.co/api/tracking/script.js?pid=YOUR_PROGRAM_ID"
></script>
  1. Apply the change and publish the site.
Wix custom code runs on the published site, not in editor preview.

Checkout compatibility on Wix

FlowStatus with AgentRef
Stripe Payment Links, Buy Buttons, or Pricing Tables on Wix pagesSupported directly.
Custom Stripe checkout outside Wix StoresSupported with the Stripe guide.
Wix Stores or another Wix-native ecommerce checkoutNot an automatic AgentRef attribution surface today.
  • Shared subdomains under one root work best when AgentRef is installed on both sides of the journey.
  • Different root domains cannot share first-party cookies automatically.
  • If you use a cookie banner, call window.AgentRef.setConsent('granted') after opt-in.

Verify the installation

  1. Publish the site.
  2. Visit the live Wix domain through a real affiliate link.
  3. Confirm agentref_cid and agentref_pid in browser cookies.
  4. Add ?agentref_debug=1 and inspect the console.
  5. If you use custom Stripe checkout, verify the Stripe guide path too.

Troubleshooting

  • The code is saved in Wix but not live: publish the site again after the change.
  • Clicks appear but no conversion does: you are likely in a Wix-native checkout path or missing the Stripe metadata bridge.
  • Cookies disappear between marketing site and app: install AgentRef on both subdomains and keep them on one root domain.

Stripe Checkout

Required for custom Wix-to-Stripe flows.

Server-Side Tracking

Fallback when the platform-owned checkout cannot pass AgentRef automatically.

Consent and GDPR

Coordinate AgentRef with your privacy banner.