Netlify Setup

If your site is hosted on Netlify, you can connect via OAuth. Trakkr uses a Netlify Edge Function to detect AI crawler visits server-side.

Before you start

You'll need:

• A Netlify account with a deployed site
• Permission to authorize third-party apps on your Netlify team

Step 1: Connect via OAuth

1. 1Navigate to the Crawler Tracking page in Trakkr
2. 2Click Connect on the Netlify card
3. 3Click Connect with Netlify
4. 4You'll be redirected to Netlify to authorize Trakkr

Trakkr requests read access to your Netlify account. We use this to:

• List your sites so you can pick which one to track
• Help you set up the Edge Function for crawler detection

1. 1Click Authorize in Netlify
2. 2You'll be redirected back to Trakkr

Step 2: Select a site

After authorization, select the Netlify site you want to track.

How the Edge Function works

Once connected, Trakkr guides you to add a Netlify Edge Function to your site. This function runs at the edge (before your site's code) and inspects incoming requests:

• AI crawler detected (GPTBot, ClaudeBot, PerplexityBot, etc.) → reported to Trakkr in real time
• Human visitor → passed through with zero impact

The Edge Function adds less than 1ms of latency to requests. It doesn't modify your site's content or behavior in any way.

Troubleshooting

OAuth redirect issues

• Ensure pop-ups aren't blocked in your browser
• If you manage multiple Netlify teams, make sure you authorize the correct one
• Clear browser cache and try again

No data after connecting

• The Edge Function needs to be deployed with your site. Trigger a redeploy in Netlify
• AI crawlers visit periodically - give it 24-48 hours for data to appear
• Check that your Netlify site is receiving traffic

Edge Function errors

• Check Netlify's Functions tab in your site dashboard for error logs
• Ensure your Netlify build settings allow Edge Functions
• Contact support if the Edge Function fails to deploy

Revoking access

To disconnect:

1. 1Remove the connection in Trakkr (Crawler Tracking page)
2. 2Remove the Edge Function from your Netlify site (optional - it won't report to Trakkr without an active connection)
3. 3Optionally, revoke Trakkr's access in Netlify: Site Settings > Access Control > OAuth

Next steps