Squarespace Integration

Install AgentRef with Squarespace code injection and understand where Squarespace-native checkout does or does not map to AgentRef automatically.

Squarespace is a good AgentRef fit for marketing pages and hosted Stripe surfaces. As with other website builders, the important distinction is whether Squarespace only renders the page or also owns the checkout.

Before you start

• Set the program website in AgentRef to the same root domain as your Squarespace site.
• Copy the exact script snippet from Settings -> Integration.
• If checkout begins on another subdomain, install AgentRef there too.

Install the script with code injection

1. Open your Squarespace site dashboard.
2. Go to Settings -> Developer Tools -> Code Injection.
3. Paste the AgentRef script into the Header field.

<script
  defer
  src="https://www.agentref.co/api/tracking/script.js?pid=YOUR_PROGRAM_ID"
></script>

4. Save the change.

Squarespace code injection is typically available on Business plans and higher.

Checkout compatibility on Squarespace

Flow	Status with AgentRef
Stripe Payment Links, Buy Buttons, or Pricing Tables embedded on Squarespace pages	Supported directly.
Custom Stripe checkout outside Squarespace Commerce	Supported with the Stripe guide.
Squarespace-native commerce checkout	Not an automatic AgentRef attribution surface today.

Multi-domain and consent notes

• Shared subdomains under one root can work well if AgentRef is installed on every surface that starts the journey.
• Different root domains do not share first-party cookies automatically.
• If you use a consent banner, call window.AgentRef.setConsent('granted') after opt-in.

Verify the installation

1. Open a live referral visit

   Use a real affiliate link on the published Squarespace domain.

2. Confirm cookies

   Check for agentref_cid and agentref_pid in DevTools.

3. Use debug mode

   Add ?agentref_debug=1 and inspect the console.

4. Validate your checkout path

   If you use anything beyond hosted Stripe surfaces, follow the Stripe guide.

Troubleshooting

• The script is saved but cookies never appear: confirm the published domain matches the website configured in AgentRef.
• Clicks exist but conversions do not: Squarespace Commerce native checkout is not an automatic AgentRef conversion path.
• The flow crosses into another domain: first-party cookies will not move across root domains without a deliberate handoff.

Related docs

Stripe Checkout

Required for custom Squarespace-to-Stripe flows.

How Tracking Works

Understand the full click-to-conversion pipeline.

Consent and GDPR

Coordinate AgentRef with your privacy banner.