Pick only as much precision as your use case requires to balance accuracy, speed, and cost.
When to Use This Guide
Use this before publishing new monetized content, changing integrations, or troubleshooting connection issues.
Before You Start
- You are logged into WordPress with an Administrator account.
- You can access PassiveWP -> Settings.
- You have any required keys or partner credentials ready.
Exact Menu Path
WordPress Admin -> PassiveWP -> Settings -> Geolocation
Step-by-Step Walkthrough
Step 1: Use country-level precision for most affiliate routing use cases.
Go here WordPress Admin→PassiveWP→Settings→Geolocation
Do this In WordPress Admin→PassiveWP→Settings→Geolocation, do this in order: open the relevant panel, find the control related to "Use country-level precision for most affiliate routing use cases.", apply one change, click Save/Run, then reload once to confirm it stuck.
Confirm Test clicks should land on the expected destination with attribution parameters intact.
Step 2: Use city-level only when your offers differ significantly by local region.
Go here WordPress Admin→PassiveWP→Settings→Geolocation
Do this In WordPress Admin→PassiveWP→Settings→Geolocation, do this in order: open the relevant panel, find the control related to "Use city-level only when your offers differ significantly by local region.", apply one change, click Save/Run, then reload once to confirm it stuck.
Confirm No blocking error banner appears, and the next step is available.
Step 3: Run before/after tests on high-volume links to confirm impact.
Go here WordPress Admin→PassiveWP→Settings→Geolocation
Do this In WordPress Admin→PassiveWP→Settings→Geolocation, click "Check API Connections" and confirm the location lookup succeeds.
Confirm MaxMind test should return a valid geo result and no blocking error.
Step 4: Document which links depend on geolocation so troubleshooting is easier.
Go here WordPress Admin→PassiveWP→Settings→Geolocation
Do this In WordPress Admin→PassiveWP→Settings→Geolocation, do this in order: open the relevant panel, find the control related to "Document which links depend on geolocation so troubleshooting is easier.", apply one change, click Save/Run, then reload once to confirm it stuck.
Confirm Test clicks should land on the expected destination with attribution parameters intact.
Quick Troubleshooting Checks
- Re-open the same settings tab and confirm values are still present.
- Run the built-in test for that integration (Amazon/OpenAI/MaxMind).
- If a key is defined in wp-config, update it there instead of the UI field.
Common Mistakes to Avoid
- Leaving defaults in place without checking if they match your niche.
- Ignoring failed connection tests before publishing monetized content.
- Using invalid or expired credentials and expecting background jobs to recover.
Success Checklist
- Connection test returns success.
- Defaults match your target country and monetization style.
- A test post renders correctly on desktop and mobile.
Pro Tips for Affiliate Marketers
- Re-test credentials after rotating keys.
- Keep credentials in one secure document so your team stays synced.
- Review settings monthly, especially before seasonal campaigns.
If You Get Stuck
Open the matching troubleshooting article in this help center and repeat one step at a time instead of changing multiple settings at once.
