Documentation
GeoSwap gives you ten geo-targeting tools in one dashboard, powered by a single script. These docs cover everything from your first install to advanced A/B testing and API access.
<50ms
Edge-powered
Geo decisions happen on Cloudflare’s edge network, not your server.
1 script
10 products
Redirects, links, content, bars, popups, blocks, consents, currencies, scripts, routes.
65+ bots
SEO-safe
Search engines and AI crawlers see your original page. Always.
$0/mo
Free forever
Every feature. Unlimited usage. No credit card.
Getting Started
New to GeoSwap? Start here.
Quick Start
Start HereGo from zero to live geo-targeting in under 60 seconds. Copy one script, create your first rule, done.
Installation
Platform-specific guides for Shopify, WordPress, Webflow, Next.js, and any HTML site.
How It Works
One script. Twelve tools. Decisions made at the edge in under 50ms. Here’s what happens behind the scenes.
Core Concepts
Understand the building blocks that make GeoSwap different from every other geo-targeting tool.
Segments
Key ConceptThe building block of all geo-targeting. Define who you’re targeting — by country, state, city, radius, or IP — and reuse it everywhere.
Variants
Each segment gets its own content, destination, or behavior. Variants are how you say “show this to Europe, that to Asia.”
Workspaces
Your project hub. One workspace per website, with its own team, domains, rules, and analytics.
SEO Safety
How GeoSwap protects your search rankings. Googlebot is never redirected, hreflang tags are auto-generated, and 65+ bots are handled correctly.
A/B Testing
Split traffic between two variants to see which performs better. Built into links, content rules, bars, and popups.
Products
Ten tools, one script. Each product targets visitors differently based on location.
Geo Redirects
Send visitors to a different URL based on their location. Auto, popup, or bar mode.
Geo Links
Smart short links that route visitors to different destinations by country.
Geo Content
Swap text, images, CTAs, or entire sections on a page based on visitor location.
Geo Routes
Manage all your redirects in one dashboard. Import from CSV, detect chains and loops.
Geo Bars
NewLocation-targeted notification bars at the top or bottom of your page.
Geo Popups
NewModal popups that appear only for visitors in specific locations.
Geo Blocks
NewRestrict access to pages by location. Show a message, popup, or redirect instead.
Geo Consents
NewCookie consent banners targeted by region. Show GDPR notices only in Europe.
Geo Currencies
NewAutomatically convert prices on your page to the visitor’s local currency.
Geo Scripts
NewRun custom JavaScript only for visitors in specific locations.
Dashboard & Settings
Analytics, domains, team management, and billing.
Analytics
Track clicks, views, and conversions by country, device, browser, and referrer.
Custom Domains
Use your own domain for geo links. Automatic SSL, simple DNS setup.
Team Management
Invite teammates with owner, admin, or viewer roles.
Billing & Plans
What’s free, what’s Pro, and how to manage your subscription.
Resources
Migration guides, SEO best practices, and bot compatibility.
Switch from Geo Targetly
Step-by-step migration guide. Same features, zero cost.
Switch from GeoFli
Move your content personalization rules to GeoSwap in minutes.
SEO Best Practices
The complete guide to geo-targeting without hurting your search rankings.
Bot Compatibility
How GeoSwap handles 65+ bots: search engines, AI crawlers, social media, and SEO tools.
API Reference
Full REST API documentation for programmatic access to all GeoSwap features.
Coming SoonReady to get started?
Create your free account and add geo-targeting to your site in under 60 seconds.