Common Issues & Solutions
Find solutions to common AffRank issues and get your system running smoothly.
Installation Issues
Script Not Loading
Symptom: Browser console shows no AffRank message when you visit your site.
Causes & Solutions:
-
Wrong User ID
- Copy fresh script from dashboard
- Verify entire URL is correct
- No typos in User ID
-
Script not in
<head>tag- Check script placement in HTML
- Should be between
<head>and</head> - Not in body or footer
-
Browser Cache
- Press Ctrl+Shift+Del (or Cmd+Shift+Del on Mac)
- Clear “All time”
- Refresh page
-
Browser Extensions Blocking
- Try incognito/private mode
- Try different browser
- Check extension settings
-
Content Security Policy
- Check if CSP headers block scripts
- Add affrank.io to whitelist if needed
- Contact hosting support if unsure
Verification: Press F12, go to Console tab, should see AffRank v1.x loaded successfully
Domain Won’t Verify
Symptom: Script loads but domain shows unverified in dashboard.
Solutions:
-
Wait Longer
- Wait 10 minutes after script install
- Visit your website to trigger load
- Try clicking Verify again
-
Verify Script Installation
- Check script is in
<head>tag - Verify full script is installed (not truncated)
- Check no JavaScript errors (F12 console)
- Check script is in
-
Contact Support
- If still not verifying after 15 minutes
- Email [email protected]
- Include domain name and screenshot
Link Issues
Links Not Appearing
Symptom: Script loads but no affiliate links appear on your pages.
Check These First:
-
Verify Script is Active
- F12 Console → Should show “AffRank loaded”
- Page source → Script tag present
- Network tab → Script request shows 200 status
-
Verify Keywords Exist
- Go to Affiliate Links dashboard
- Confirm link is created and active
- Check link is not paused
- Verify keyword hasn’t been archived
-
Verify Keywords Match Content
- Keyword: “best web hosting”
- Your content must contain exact phrase
- Check capitalization if using Exact Match
- Try Partial or Smart Match if needed
-
Wait for Sync
- Changes can take 5-10 minutes
- Try refreshing page after 10 minutes
- Clear browser cache
- Try different page with keyword
-
Check Exclude Patterns
- Go to link settings
- Verify page is not in exclude list
- Update excludes if too restrictive
Low Click Performance
Symptom: Links appear but very few clicks recorded.
Optimization Steps:
-
Check Link Placement
- Links at top of page perform better
- First mention usually gets clicks
- Try placing near call-to-action
-
Review Link Text
- Use keyword naturally
- Make link text descriptive
- Avoid generic “click here”
- Test different link text
-
Verify Link Destination
- Test link manually
- Ensure destination loads
- Check affiliate program still active
- Verify no error pages
-
Test Tracking
- Click your own link
- Check analytics within 5 minute
- Verify click is recorded
- If not, check “Enable Tracking”
-
Analyze Traffic
- Check if pages get traffic
- Use Google Analytics to verify
- Low clicks often = low traffic
- Get more traffic to the page
Analytics Issues
No Click Data Showing
Symptom: Analytics dashboard is empty.
Check:
-
Verify Date Range
- Check date selector
- Are you looking at right date range?
- Clicks must occur in selected range
-
Verify Domain Selected
- Check which domain is selected
- Clicks only show for active domains
- Multi-domain users: select correct domain
-
Verify Links Active
- Go to Affiliate Links
- Check link status (active/paused/archived)
- Archived links won’t show clicks
- Reactivate if needed
-
Verify Tracking Enabled
- Check link settings
- “Tracking Enabled” should show true
- Enable if disabled
-
Check Time Zone
- Dashboard settings → Time Zone
- Should match your local time
- Wrong TZ? Shifts all times
Data Seems Low
Possible Causes:
-
Script Not On All Pages
- Install script on homepage
- Install on blog/content pages
- Install on landing pages
- Script must be on target pages
-
Keywords Too Specific
- “Apple MacBook Pro 2025” - too narrow
- Change to broader: “best laptop”
- Use Smart Match for flexibility
- Test different keywords
-
Links Not Active
- Check all links are “Active”
- Paused links won’t insert
- Resume paused links
- Delete and recreate if needed
-
Low Traffic to Pages
- High CTR, low clicks = low traffic
- Drive more traffic to pages
- Use SEO, ads, social shares
- Attract more visitors
-
Technical Issues
- Script loading but not tracking?
- Check for JS errors (F12 Console)
- Verify affiliate domain not blocked
- Try different browser
Domain Issues
Domain Keeps Losing Verification
Symptom: Domain verifies, then shows unverified again later.
Causes:
-
Script Removed
- Check script still on page
- Script was accidentally deleted
- Replace script if missing
- Re-verify domain
-
Site Went Offline
- Check if site is accessible
- Bring site back online
- Verify domain again
-
Firewall Blocking
- Check server firewall rules
- AffRank server needs access
- Whitelist affrank.io if needed
-
DNS Changed
- Domain moved to new host
- DNS changed
- Update script if needed
- Re-verify domain
Can’t Add More Domains
Symptom: “Domain limit reached” error.
Solutions:
-
Check Your Plan
- Free: 1 domain
- Growth: 5 domains
- Scale: 25 domains
- Upgrade for more
-
Archive Unused Domains
- Go to Domain Management
- Archive domains you don’t use
- Frees up slot for new domain
- Can restore archived domain
-
Upgrade Your Plan
- Higher plans allow more domains
- Visit Pricing or Settings
- Upgrade to add domains
Performance Issues
Dashboard Slow
Symptom: Analytics dashboard takes long time to load or is sluggish.
Fixes:
-
Narrow Date Range
- Instead of “All Time”, try last 30 days
- Smaller ranges load faster
- Export older data if needed
-
Use Filters
- Filter by domain
- Filter by keyword
- Fewer results = faster loading
-
Clear Browser Cache
- Ctrl+Shift+Del → Clear all
- Refresh page
- Try incognito mode
-
Try Different Browser
- If one browser slow
- Try Chrome, Firefox, Safari, Edge
- Isolates browser issues
-
Check Internet Speed
- Slow internet = slow dashboard
- Test with speedtest.net
- Switch to faster connection
Scripts Slow My Site
Fact: AffRank script is extremely lightweight (<50KB) and won’t slow your site.
If you notice slowness:
-
Check Server
- Server performance issues
- Not caused by AffRank
- Check server CPU/memory
-
Check Hosting
- Contact hosting provider
- May be overloaded server
- Upgrade hosting plan
-
Site Audit
- Use PageSpeed Insights
- Check what’s slowing site
- Optimize images, fonts, etc.
Account Issues
Can’t Login
Symptom: “Invalid email or password” error.
Solutions:
-
Verify Email
- Check email is correct
- No typos
- Correct capitalization
-
Forgot Password
- Click “Forgot Password”
- Enter email
- Check email for reset link
- Create new password
-
Account Locked
- Too many login attempts
- Wait 30 minutes
- Try again
- Contact support if still locked
-
Contact Support
- If still can’t login
- Email [email protected]
- Include email address
- We’ll help you gain access
Payment Issues
Subscription Won’t Activate
-
Check Card
- Verify card details
- Not expired
- Sufficient funds
- Try different card
-
Clear Browser Cache
- Ctrl+Shift+Del
- Clear all
- Refresh page
- Try payment again
-
Contact Support
- If still not working
- Email [email protected]
- Include order details
- We’ll verify and activate
Still Need Help?
- Email Support: [email protected]
- Response Time: 24 hours on business days
- FAQ: Frequently Asked Questions
- Chat: Coming soon!
Report a Bug
Found a bug? Report it:
- Go to Settings → Report Issue
- Describe what happened
- Include screenshots if possible
- We’ll investigate and fix
Your feedback helps us improve! 🚀