Proper country/tag mapping prevents broken affiliate attribution and low-converting cross-country sends.
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 -> Amazon
Step-by-Step Walkthrough
Step 1: Set your default country to your primary buyer audience.
Where to click WordPress Admin→PassiveWP→Settings→Amazon
What to do In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
How to verify No blocking error banner appears, and the next step is available.
Step 2: Add partner tags for every country you actively target.
Where to click WordPress Admin→PassiveWP→Settings→Amazon
What to do In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
How to verify New rows should appear in the list and be editable.
Step 3: Set a default partner tag for fallback behavior.
Where to click WordPress Admin→PassiveWP→Settings→Amazon
What to do In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
How to verify No blocking error banner appears, and the next step is available.
Step 4: Validate country-specific tags using the Amazon test tool.
Where to click WordPress Admin→PassiveWP→Settings→Amazon
What to do In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
How to verify Check API Connections should show successful status with no country-level errors.
Step 5: Click through links from a VPN or test environment for key regions.
Where to click WordPress Admin→PassiveWP→Settings→Amazon
What to do In WordPress Admin→PassiveWP→Settings→Amazon, click "Check API Connections" and wait for the status table to finish.
How to verify Check API Connections should show successful status with no country-level errors.
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.
