> For the complete documentation index, see [llms.txt](https://docs.yaycommerce.com/yaycurrency/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaycommerce.com/yaycurrency/configurations/settings/geo-api-option-detects-the-country-by-ip.md).

# Geo API option detects the country by IP

<figure><img src="https://2217518750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_yR1oHovFi42XBPZIi%2Fuploads%2FTk6CbvPxyykrjHpeZ8rM%2Fimage.png?alt=media&amp;token=d46f06ef-f0a6-482f-94ac-eceded829b5e" alt=""><figcaption></figcaption></figure>

After enabling **Auto Select Currency by Country**, YayCurrency will automatically detect the visitor’s location and switch to the appropriate currency.

#### What Happens When Enabled

* Detects the customer’s country based on their IP address
* Automatically assigns the corresponding currency
* Displays prices in the visitor’s **local currency**
* Falls back to the default currency if no match is found

#### Geo API

Choose how the system detects the visitor’s country:

* **Auto detect:** Uses the best available method with built-in fallback
* **WooCommerce Geolocation (Recommended):** Uses WooCommerce’s default geolocation
* **MaxMind Geolocation:** Requires setup in WooCommerce
* **IP2Location:** Uses an external IP-based service

#### Cache Method *(Auto detect only)*

This option is available only when **Auto detect** is selected.

Control how location data is cached to improve performance:

* **No cache:** Always perform real-time detection
* **Transient:** Store data using WordPress transient caching
* **File:** Store cached data in files on the server
