Geolocation Testing
Test your application from different countries using proxy servers to simulate users in 110+ locations worldwide
Geolocation Testing
Test-Lab can route your tests through proxy servers in different countries, allowing you to test geo-restricted content, localized pricing, regional compliance banners, and location-based features.
Why Geolocation Testing?
Your application may behave differently depending on where users access it from:
- Geo-blocked content - Pages that only load in certain regions
- Localized pricing - Different currencies, prices, or payment methods by region
- Regional compliance - GDPR banners in EU, CCPA in California, cookie consent
- CDN behavior - Content served from regional edge nodes
- Language redirects - Sites that auto-redirect based on IP location
How It Works
When you select a country other than the United States, Test-Lab routes your test traffic through a proxy server in that country. The target website sees an IP address from that location and serves region-specific content accordingly.
We use NordVPN as our primary proxy provider, with BrightData as a fallback. Both providers offer reliable datacenter proxies with consistent uptime across 110+ countries.
Selecting United States means no proxy is used - tests run directly from our servers in the US. This is the fastest option and recommended for most tests.
Location Hierarchy
Geolocation can be configured at two levels:
Project default → Test Plan override| Level | Scope | When to Use |
|---|---|---|
| Project | All test plans in the project | Same location for all tests |
| Test Plan | Single test plan | Override project default for specific tests |
Test plan settings override project settings. If a test plan has no location set, it inherits the project default.
Configuring Project Location
Set a default location for all test plans in a project:
- Go to Projects in the admin dashboard
- Click Edit on your project
- Select a country from the Location dropdown
- Click Save
All test plans in this project will use this location unless they specify their own.
Configuring Test Plan Location
Override the project default for a specific test plan:
- Go to Test Plans in the admin dashboard
- Click Edit on your test plan
- Expand Advanced Settings
- Select a country from the Location dropdown
- Click Save
Supported Countries
We support 110+ countries across all major regions:
Americas United States, Canada, Mexico, Brazil, Argentina, Chile, Colombia, and 20+ more
Europe United Kingdom, Germany, France, Spain, Italy, Netherlands, Poland, and 30+ more
Asia Pacific Japan, Australia, Singapore, India, South Korea, Hong Kong, and 25+ more
Middle East & Africa UAE, Israel, South Africa, Egypt, Turkey, and 20+ more
The complete list is available in the Location dropdown in the dashboard.
Use Cases
Testing Regional Pricing
Go to the pricing page and verify:
1. Prices are displayed in Euros (€)
2. VAT is shown for EU customers
3. The correct payment methods are availableRun this test from Germany, France, and UK to verify localized pricing.
Verifying GDPR Compliance
Go to the homepage and verify:
1. A cookie consent banner appears
2. Users can reject non-essential cookies
3. The privacy policy link is accessibleRun from any EU country to test GDPR compliance.
Testing Geo-Restricted Content
Navigate to the video library and verify:
1. The video player loads
2. Content is accessible (not blocked)
3. Playback starts without errorsRun from different regions to identify where content is blocked.
API Usage
When triggering tests via API, the configured project and test plan locations are automatically applied. You cannot override the location via API - it must be configured in the dashboard.
curl -X POST https://test-lab.ai/api/v1/run \
-H "Authorization: Bearer tl_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"testPlanId": 123
}'The test will run from the location configured on the test plan, or the project default if not set.
Performance Considerations
- Proxy overhead - Tests routed through proxies may be slightly slower due to network hops
- United States is fastest - No proxy means direct connection to test servers
- Regional latency - Tests from distant regions (e.g., Australia, Asia) may have higher latency
For time-sensitive tests or frequent iteration, consider using US location and only switching to regional testing for specific scenarios.
Custom Proxy Configuration
If your organization requires a specific proxy provider (corporate VPN, residential proxies, custom routing), contact us to discuss custom configuration options.
Availability
Geolocation testing is available on Custom plans. Proxy costs are included in the plan pricing.
If you're on Pay As You Go and need geolocation testing, contact us to discuss upgrading.