Locations

Local discovery

Pro: start visitors on stations from their own country.

2 min readUpdated TuneSera

On this page
  1. Turn on local discovery
  2. How it works
  3. Privacy
  4. Related articles

Local discovery starts each visitor’s directory with stations from their own country, so a listener in Brazil sees Brazilian stations first and a listener in Bangladesh sees Bangladeshi ones.

Pro feature. This feature needs TuneSera Pro with an active license. Get TuneSera Pro

Turn on local discovery#

  1. Go to TuneSera → Settings → Local discovery.
  2. Turn on Detect visitor country.
  3. Optionally enter a Fallback country: a two-letter code such as BD, used when a visitor’s country can’t be detected. Leave it blank to show all countries in that case.
  4. Click Save changes.
Local discovery settings with Detect visitor country turned on and a Fallback country field
Local discovery settings.

How it works#

  • When a visitor opens the directory without choosing any filters, TuneSera looks up their country and filters the list to it.
  • If the visitor’s country has no stations, or the lookup fails, they see the fallback country or all stations.
  • Visitors stay in control: picking a different country, or choosing all countries, always takes priority, and so do filters in the page address.
  • Country archive pages keep showing their own country.

Privacy#

To find the country, each visitor’s browser asks the free country.is service, which receives the visitor’s IP address. No precise location is requested, and visitors don’t see a location permission prompt. The result is remembered in the browser for one hour. Local discovery is off by default. Mention country.is in your privacy policy if you turn it on.

Developers can point the lookup at a different service with the tunesera_pro_country_lookup_url filter.

Still stuck?Our team usually replies the same day. Open a private ticket and we'll help you sort it out. Open a ticket