Troubleshooting

Script Not Working

The GeoSwap script isn't loading or doesn't seem to be doing anything. Here's what to check:

Rules Not Firing

The script is loaded but your rules aren't doing anything. Walk through these checks:

Is the rule active?

Paused rules won't fire. Check that the rule's status is set to Active in the dashboard. Look for the toggle switch on the rule detail page.

Does the visitor's location match the segment?

If you're testing from your own location, make sure your country or region is included in the segment. Your IP might resolve to a different location than you expect, especially if you're on a VPN or corporate network.

Check your page targeting

Rules can be scoped to specific URLs or URL patterns. Make sure the rule is set to apply to the page you're testing on. Check the "Page targeting" section of the rule.

Use the Rule Simulator

The fastest way to debug is the Rule Simulator. Pick a country, device, and page URL, then click Simulate. It shows you exactly which rule matches and why \u2014 or why nothing matched.

Content Flash (FOUC)

You see the original content for a split second before GeoSwap swaps in the personalized version. This is called a "flash of unstyled content" (FOUC). Here's how to fix it:

<style>
  /* GeoSwap anti-flicker — hides body until rules are applied */
  body { opacity: 0 !important; }
</style>
<script>
  // Fallback: show page after 3s even if GeoSwap hasn't loaded
  setTimeout(function() {
    document.body.style.opacity = '1';
  }, 3000);
</script>

GeoSwap automatically removes the opacity: 0 style once rules are applied, so your page appears as soon as the correct content is in place.

Redirect Loops

The visitor keeps bouncing between two pages endlessly. This happens when two rules conflict with each other.

Common cause: overlapping rules

If you have a rule that redirects A → B and another that redirects B → A, visitors will loop forever. Check your rules for circular patterns.

Use explicit country matching

"Not equal to" rules are the most common source of loops. Instead of "redirect everyone NOT in the US," create explicit rules for each country you want to redirect. This prevents unexpected matches.

Enable "once per session"

This option makes GeoSwap redirect a visitor only once per browser session. If they navigate back, they won't be redirected again. It's a good safety net.

Bot Traffic in Analytics

Wondering if bots are skewing your numbers? They're not.

GeoSwap automatically separates bot and human traffic. Bots are never included in your main analytics metrics.

Check the Bot Intelligence tab in your dashboard for bot-specific data — which bots visited, how often, and what they accessed.

AI crawlers (ChatGPT, Claude, Perplexity) are detected and tracked separately, so you can see how AI systems interact with your site.

Custom Domain Not Verifying

You added a custom domain but GeoSwap says it's not verified yet. Here's what to check: