Title: IP Locator
Author: Pierre Lannoy
Published: <strong>Abril 2, 2020</strong>
Last modified: Marso 20, 2026

---

Search plugins

![](https://ps.w.org/ip-locator/assets/icon-256x256.png?rev=2274203)

# IP Locator

 By [Pierre Lannoy](https://profiles.wordpress.org/pierrelannoy/)

[Download](https://downloads.wordpress.org/plugin/ip-locator.4.4.0.zip)

 * [Details](https://ceb.wordpress.org/plugins/ip-locator/#description)
 * [Reviews](https://ceb.wordpress.org/plugins/ip-locator/#reviews)
 *  [Installation](https://ceb.wordpress.org/plugins/ip-locator/#installation)
 * [Development](https://ceb.wordpress.org/plugins/ip-locator/#developers)

 [Support](https://wordpress.org/support/plugin/ip-locator/)

## Description

**IP Locator** is a country and language detection tool for WordPress. It is fast,
reliable and plug & play.

It can detect and render the country, the main language and the country flag of 
each visitor of your site. It provides:

 * a strong, accurate and ultra-fast IP and country detection;
 * many shortcodes to display country names, languages and flags (emoji or vectorized);
 * a shortcode to conditionally hide or show strings or other shortcodes;
 * a CSS modifier to add a country-specific class to the `body` tag of your site;
 * an automatic system to be always up to date (no API key, no IP data files to 
   manually import);
 * a full-featured API for plugins / themes developers.

For full details, you can browse [the shortcodes list](https://github.com/Pierre-Lannoy/wp-ip-locator/blob/master/SHORTCODES.md)
or [the API description](https://github.com/Pierre-Lannoy/wp-ip-locator/blob/master/DEVELOPER.md)(
for developers).

**IP Locator** can be used too to report the following main items and characteristics:

 * KPIs: number of detected countries and languages, accesses breakdown and detection
   ratio;
 * countries for real humans with public IPs;
 * languages for real humans with public IPs;
 * metrics variations;
 * metrics distributions;
 * full list of countries per channel;
 * full list of countries per client (requires the free [Device Detector](https://wordpress.org/plugins/device-detector/)
   plugin).

Technically, **IP Locator**:

 * works on dedicated or shared servers;
 * can detect the source IP even behind proxies or load-balancers;
 * can use AWS CloudFront, Cloudflare and Apache mod_geoip to speed-up detection;
 * natively supports APCu caching(1) and all other dedicated object caching mechanisms,
   like Memcached or Redis;
 * has a minimal footprint in the page rendering time;
 * runs its data updates in background, without impact on the website speed;
 * is fully compatible with multisites;
 * natively supports names and languages localizations(2).

(1): [APCu](https://www.php.net/manual/en/intro.apcu.php) needs to be activated 
on your server if you want to use it in IP Locator.

(2): [PHP Intl extension](https://www.php.net/manual/en/intro.intl.php) needs to
be activated on your server if you want to use it in IP Locator.

> **IP Locator uses IP data I curate myself and I publish via my own servers exclusively
> for IP Locator. Data is CC0 licensed.**
>  **IP Locator accesses this service on
> a regular basis (if the option is checked) to maintain an up-to-date version of
> the data.**

**IP Locator** supports an extensive set of WP-CLI commands to:

 * get location detail: see `wp help location describe` for details;
 * display IP Locator status: see `wp help location status` for details;
 * toggle on/off main settings: see `wp help location settings` for details;
 * display location and languages statistics: see `wp help location analytics` for
   details.

For a full help on WP-CLI commands in IP Locator, please [read this guide](https://perfops.one/ip-locator-wpcli).

> **IP Locator** is part of [PerfOps One](https://perfops.one/), a suite of free
> and open source WordPress plugins dedicated to observability and operations performance.

**IP Locator** is a free and open source plugin for WordPress. It integrates many
other free and open source works (as-is or modified). Please, see ‘about’ tab in
the plugin settings to see the details.

#### Developers

If you’re a plugins / themes developer and want to take advantage of the detection
features of IP Locator, visit the [GitHub repository](https://github.com/Pierre-Lannoy/wp-ip-locator)
of the plugin to learn how to use it.

#### Support

This plugin is free and provided without warranty of any kind. Use it at your own
risk, I’m not responsible for any improper use of this plugin, nor for any damage
it might cause to your site. Always backup all your data before installing a new
plugin.

Anyway, I’ll be glad to help you if you encounter issues when using this plugin.
Please read carefully the FAQ at the bottom of this page before requesting support.

#### Privacy

This plugin, as any piece of software, is neither compliant nor non-compliant with
privacy laws and regulations. It is your responsibility to use it – by activating
the corresponding options or services – with respect for the personal data of your
users and applicable laws.

This plugin doesn’t set any cookie in the user’s browser.

This plugin may handle personally identifiable information (PII). If the GDPR or
CCPA or similar regulation applies to your case, you must adapt your processes (
consent management, security measure, treatment register, etc.).

#### Donation

If you like this plugin or find it useful and want to thank me for the work done,
please consider making a donation to [La Quadrature Du Net](https://www.laquadrature.net/en)
or the [Electronic Frontier Foundation](https://www.eff.org/) which are advocacy
groups defending the rights and freedoms of citizens on the Internet. By supporting
them, you help the daily actions they perform to defend our fundamental freedoms!

## Screenshots

 * [[
 * Main Analytics Dashboard

## Installation

#### From your WordPress dashboard

 1. Visit ‘Plugins > Add New’.
 2. Search for ‘IP Locator’.
 3. Click on the ‘Install Now’ button.
 4. Activate IP Locator.

#### From WordPress.org

 1. Download IP Locator.
 2. Upload the `ip-locator` directory to your `/wp-content/plugins/` directory, using
    your favorite method (ftp, sftp, scp, etc…).
 3. Activate IP Locator from your Plugins page.

#### Once Activated

 1. Visit ‘PerfOps One > Control Center > IP Locator’ in the left-hand menu of your
    WP Admin to adjust settings.
 2. Enjoy!

## FAQ

### Can this plugin work on multisite?

Yes. It is designed to work on multisite too. Network Admins can configure the plugin.
All sites users can use plugin features (shortcodes and APIs).

### Where can I get support?

Support is provided via the official [WordPress page](https://wordpress.org/support/plugin/ip-locator/).
Because I am human myself, please note that I only answer to support requests made
by humans, who behave like humans. This excludes requests or bug reports written
by AI or those that do not adhere to basic rules of courtesy.

### Where can I find documentation?

Developer’s documentation can be found in the [GitHub repository](https://github.com/Pierre-Lannoy/wp-ip-locator)
of the plugin.

### Where can I report a bug?

You can report bugs and suggest ideas via the [GitHub issue tracker](https://github.com/Pierre-Lannoy/wp-ip-locator/issues)
of the plugin.

## Reviews

![](https://secure.gravatar.com/avatar/4c90d9eb6a198f4489b043c90df64fbc5ab0ad949aa8642ae9e117a7beb17e39?
s=60&d=retro&r=g)

### 󠀁[Good plugin](https://wordpress.org/support/topic/good-plugin-6590/)󠁿

 [nene](https://profiles.wordpress.org/wpdreamer/) Setyembre 24, 2023 1 reply

I like the PerfOne plugin set. Thank you!

 [ Read all 1 review ](https://wordpress.org/support/plugin/ip-locator/reviews/)

## Contributors & Developers

“IP Locator” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ Pierre Lannoy ](https://profiles.wordpress.org/pierrelannoy/)
 *   [ Hosterra ](https://profiles.wordpress.org/hosterra/)

“IP Locator” has been translated into 3 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/ip-locator/contributors)
for their contributions.

[Translate “IP Locator” into your language.](https://translate.wordpress.org/projects/wp-plugins/ip-locator)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/ip-locator/), check
out the [SVN repository](https://plugins.svn.wordpress.org/ip-locator/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/ip-locator/) by 
[RSS](https://plugins.trac.wordpress.org/log/ip-locator/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

Please, see [full changelog](https://perfops.one/ip-locator-changelog).

## Community plugin

This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/Pierre-Lannoy/wp-ip-locator)

## Meta

 *  Version **4.4.0**
 *  Last updated **3 Semana ago**
 *  Active installations **600+**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.2 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/ip-locator/), [French (Belgium)](https://fr-be.wordpress.org/plugins/ip-locator/),
   [French (Canada)](https://fr-ca.wordpress.org/plugins/ip-locator/), and [French (France)](https://fr.wordpress.org/plugins/ip-locator/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/ip-locator)
 * Tags
 * [country](https://ceb.wordpress.org/plugins/tags/country/)[decalog](https://ceb.wordpress.org/plugins/tags/decalog/)
   [flag](https://ceb.wordpress.org/plugins/tags/flag/)[geolocation](https://ceb.wordpress.org/plugins/tags/geolocation/)
   [language](https://ceb.wordpress.org/plugins/tags/language/)
 *  [Advanced View](https://ceb.wordpress.org/plugins/ip-locator/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/ip-locator/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/ip-locator/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/ip-locator/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/ip-locator/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/ip-locator/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/ip-locator/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ip-locator/reviews/)

## Contributors

 *   [ Pierre Lannoy ](https://profiles.wordpress.org/pierrelannoy/)
 *   [ Hosterra ](https://profiles.wordpress.org/hosterra/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ip-locator/)