Docs
← Back to site

Geo Targeting

3 min readUpdated June 15, 2026

Geo targeting lets you show or hide individual links on a bio page based on the visitor’s country. Use it to surface region-specific promotions, local booking links, country-specific platforms, or language-appropriate destinations — without creating separate bio pages per market.

How it works#

Geo rules are embedded in the bio page HTML at render time and evaluated client-side by a lightweight JavaScript call to the plugin’s REST endpoint (/wp-json/nlb/v1/geo). This endpoint is never cached by page caches or CDNs — it always returns a fresh country result for the current visitor.

Because the evaluation happens client-side after the page loads, geo targeting works with any page cache or CDN setup. You do not need to configure cache exclusions or bypass rules.

  1. In the bio page editor, find the link you want to target
  2. Click the globe icon in the link’s toolbar
  3. The geo panel expands below the link row
  4. Choose a mode:
    • In all countries — default, no targeting applied
    • Only in selected countries — link is visible only to visitors in the selected countries, hidden everywhere else
    • Hide in selected countries — link is visible everywhere except the selected countries
  5. Search for and select countries using the country picker
  6. Selected countries appear as chips with flag icons — click × on a chip to remove it
  7. A dot appears on the globe icon in the toolbar when geo targeting is active on that link

Geo detection#

WP LinkCanvas detects visitor country in this order:

  1. CDN headers — if the site is proxied through Cloudflare or Bunny.net, the country is read from CF-IPCountry or X-Bunny-Country headers. This is instant — zero API latency.
  2. IP geolocation API — if no CDN header is found, an API lookup resolves the country from the visitor’s IP address.

Configure the detection provider at Link Bio → Geo Detection. Options are:

  • Auto (default) — uses CDN headers first, falls back to freeipapi.com. Works for most installs with no setup needed.
  • CDN only — CDN headers only, no API fallback. Fastest option, but requires the site to be proxied through Cloudflare or Bunny.net.
  • freeipapi.com — IP geolocation with optional Pro API key for higher rate limits.
  • IP2Location.io — IP geolocation using an IP2Location API key.

Combining with scheduling#

Geo targeting and link scheduling can be used on the same link. A link that is both geo-targeted and scheduled only appears for visitors in the selected countries during the scheduled window.

Languages and geo targeting#

Geo rules apply at the link level, not the language level. A link set to “Only in selected countries” is hidden from those countries regardless of which language version of the bio page they are viewing.

Tips#

Use geo targeting to:

  • Show a local phone number or WhatsApp link only in specific countries
  • Promote a regional platform (like a local streaming service) only where it is available
  • Hide a link to a product that does not ship to certain regions