Common Issues

Script not loading

Symptom: The Network tab in DevTools shows no request to api.affrank.ai when you load your page.

Check:

The script tag is in <head>, not in <body> or footer
Your User ID in the script URL is correct — copy the full script tag from Dashboard → Domain & Script to be sure
No browser extension (ad blocker, privacy extension) is blocking the request — test in a private/incognito window
Right-click your page → View Page Source — search for api.affrank.ai to confirm the tag is actually being served

Symptom: You click Verify and the domain stays unverified.

Check:

You actually visited your website (navigated to a page) after installing the script — just having a tab open doesn’t count
The script is in <head> — verification requires the script to load, and scripts in the footer may be blocked
You’re clicking Verify within 10 minutes of visiting the site — the signal expires after 10 minutes. Visit the site again and then click Verify immediately
If you recently reinstalled the script, clear your browser cache and load a fresh page before verifying

Symptom: Script loads (you can see the api.affrank.ai network request returning 200), but keywords on your pages aren’t getting linked.

Check in order:

Link is Active — go to Affiliate Links, confirm the link status is Active (not toggled off)
Keyword matches exactly — AffRank does exact phrase matching. If your keyword is best web hosting, the page must contain those three words together in that order. Check for hyphenation, extra words between them, or slight variations
The text is in the page body — AffRank skips navigation menus, headers, footers, and other structural elements. The keyword must appear in the main content
Domain is verified — unverified domains don’t get link injection. Check Domain Management for the domain’s status
Link limit not exceeded — if your account is at its plan’s link limit, new links may not activate. Check your count in the dashboard

Symptom: You can see the injected links on your pages but clicks don’t show up in Analytics.

Check:

Open DevTools → Network tab, then click one of your affiliate links. Look for a POST request to api.affrank.ai — if you see it, tracking is working and the data should appear in your dashboard within seconds
Confirm you’re looking at the right domain and date range in the Analytics Dashboard
Try in incognito mode to rule out browser extensions intercepting the click

Symptom: “Domain limit reached” error when adding a new domain.

Options:

Remove a domain you’re no longer using (Domain Management → ⋯ → Remove)
Upgrade your plan: Starter supports 1 domain, Growth supports 5, Empire supports 25

Symptom: Revenue Mapping shows no data even though you have conversions in your affiliate network.

Check:

Paste your postback URL directly into a browser with real sessionId and amount values — a 200 response means the URL is correct
Check your affiliate network’s postback delivery log for errors or “failed” status
Confirm your actual User ID is in the postback URL (not the placeholder text YOUR_USER_ID)
Verify that affrank_sid is being passed through from your affiliate link to the network and returned in the postback — some networks need explicit configuration to pass sub-ID parameters through the conversion

Symptom: Revenue Mapping shows postback events but they appear unattributed.

Check:

The network must return the same sessionId value it received. Some networks truncate custom parameters or URL-encode them in a way that changes the value — check the raw postback log in AffRank versus what the network shows as the sub-ID it stored

Include the output from DevTools Network tab if the issue is script or click related.