Geo Links
Geo short links with location-based routing
What are Geo Links?
Geo Links are short URLs that automatically route visitors to different destinations based on their geographic location. Unlike geo redirects (which work on pages you control), Geo Links are standalone short URLs you can share anywhere: email campaigns, social media, print materials, or QR codes.
A single link like gswp.me/summer-sale can send US visitors to your US store, UK visitors to your UK store, and everyone else to your global storefront.
How It Works
Visitor clicks your Geo Link
The short URL (e.g., gswp.me/abc123) is handled by the GeoSwap edge network.
Edge resolves location
The Cloudflare Worker determines the visitor's country using edge-level geolocation data. No additional API calls or lookups are needed.
Matched destination is selected
Your routing rules determine which destination URL to use. If no country-specific rule matches, the default (fallback) destination is used.
Visitor is redirected
The redirect happens server-side at the edge, so it is near-instant. The visitor never sees the short URL page. Analytics are recorded asynchronously.
Creating a Geo Link
Step 1: Create a new link
In the GeoSwap dashboard, navigate to Links and click New Link.
Step 2: Set the default destination
Enter a fallback URL. This is where visitors go if none of your country-specific rules match. Every Geo Link must have a default destination.
Step 3: Add country rules
Add one or more country-specific destinations. For each rule, select the target countries and enter the destination URL.
Example: Multi-region store link
US, CA
https://store.example.com/en-us/GB, IE
https://store.example.com/en-gb/DE, AT, CH
https://store.example.com/de/Default
https://store.example.com/Step 4: Customize the slug (optional)
By default, GeoSwap generates a random short slug. You can customize it to something memorable like gswp.me/summer-sale. Custom slugs must be unique across all GeoSwap accounts.
Traffic Splits
AdvancedGeo Links support traffic splitting within a country rule. Instead of sending all US visitors to one URL, you can split traffic between multiple destinations by percentage. This is useful for A/B testing landing pages across regions.
Example: A/B test for US visitors
50%
https://store.example.com/en-us/landing-a50%
https://store.example.com/en-us/landing-bQR Codes
Auto-generated QR codes
Every Geo Link comes with a downloadable QR code (PNG or JPEG). The QR code points to your Geo Link URL, so scanning it from any country triggers the same location-based routing. Perfect for print materials, packaging, or in-store displays that need to route international customers to the right destination.
Analytics
Click tracking by country
Every Geo Link click is tracked with country, device, and referrer data. View real-time analytics in the Analytics dashboard. Bot clicks (including AI crawlers) are tracked separately so they do not skew your numbers.
Best Practices
Always set a default (fallback) destination. Without one, visitors from unmatched countries see an error.
Use descriptive custom slugs for links shared publicly (e.g., /summer-sale instead of /abc123).
Use labels to organize links by campaign, region, or team.
Review analytics regularly to see which countries drive the most traffic and adjust rules accordingly.
Use traffic splits sparingly. Start with a 50/50 split and adjust based on data.
Download QR codes at the highest resolution you need. They are generated client-side and are free to use.
Next up
Learn about content personalization to change on-page elements by location.