GeoIP Detection


Provides geographic information detected by an IP adress. This can be used in themes or other plugins,
as a shortcode, or via CSS body classes. The city & country names are translated in different languages (supported languages).


  • Provides these 5 functions (see API Documentation):
    • geoip_detect2_get_info_from_ip($ip, $locales = array('en'), $options = array()): Lookup Geo-Information of the specified IP
    • geoip_detect2_get_info_from_current_ip($locales = array('en'), $options = array()): Lookup Geo-Information of the current website user
    • geoip_detect2_get_current_source_description(...): Return a human-readable label of the currently chosen source.
    • geoip_detect2_get_external_ip_adress(): Fetch the internet adress of the webserver
    • geoip_detect2_get_client_ip(): Get client IP (even if it is behind a reverse proxy)
  • You can use one of these data sources (see comparison):
  • For the property names, see the results of a specific IP in the wordpress backend (under Tools > GeoIP Detection).
  • You can include these properties into your posts and pages by using the shortcode [geoip_detect2 property="" default="(country could not be detected)" lang="en"] (where ‘’ can be one of the other property names as well, and ‘default’ and ‘lang’ are optional).
  • When enabled on the options page, it adds CSS classes to the body tag such as geoip-country-DE and geoip-continent-EU.
  • When enabled on the options page, the client IP respects a reverse proxy of the server.
  • If you are using Contact Form 7, you can use these shortcodes:
    • A select input with all countries, the detected country being selected by default [geoip_detect2_countries mycountry]
    • Tracking information for the email text [geoip_detect2_user_info]

See API Documentation for more info.

How can I use these functions?

  • You could choose the currency of the store based on the country name
  • You could suggest an timezone to use when displaying dates
  • You could show the store nearest to your customer
  • You show or hide content specific to a geographic target group
  • Etc. … You tell me! I’m rather curious what you’ll do with this plugin!

System Requirements: You will need at least PHP 5.4.

This extension is “charity-ware”. If you are happy with it, please leave a tip for the benefit of this charity. (See FAQ for more infos.)

This product can provide GeoLite2 data created by MaxMind, available from


Does geoip_detect2_get_info_from_current_ip() return the same country, regardless of where you are visiting the site from? Maybe your server has a reverse proxy configured. You can check this: Go to the options page and look for “reverse proxy”. Are there 2 IPs listed there? If so, which one corresponds to your public IP?


  • Lookup page (under Tools > GeoIP Lookup)
  • Options page (under Preferences > GeoIP Detection)


  • Install the plugin
  • Go to the plugin’s option page and choose a data source.
  • Test it by clicking on “Lookup” on the lookup page.


Outstanding Plugin

Works perfectly! However, I do wish the documentation were complete on all the variables available. It was a pain to review MaxMind, then try variations of the variable (ie. metro_code, metrocode, metroCode) until it worked.

So many uses!

I wanted to set up a redirect based on geolocation, and was able to use the shortcode version in a simple <script> to check if the user’s location matched a list I had created. While the php side of this plugin is great, the ability to access it all through shortcodes really adds a ton of power.
Love it!

Very easy to use

Took me less than 2 hours to install and configure the plugin and modify my blog pages to display or hide divs based on visitor’s country. Love it!

Good plugin

Supplies shortcodes and shows you how to use it using php functions in case you need to do some custom programming. As a programmer this is very useful.

Read all 31 reviews

Contributors & Developers

“GeoIP Detection” is open source software. The following people have contributed to this plugin.


“GeoIP Detection” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “GeoIP Detection” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Maxmind vendor code was updated to the current version (2.7.0).
  • FIX: There was a fatal error when using PHP 7.2 (thx jj-dev)
  • FIX: The automatic update of Maxmind Geoip2 Lite City database was fixed.
  • FIX: Always try to fill in more information into the country information from the GeoNames-DB.


(Was not released on


  • FIX: Localhost now always is a trusted proxy (for standard reverse proxy configurations, however the checkbox “uses a reverse proxy” still needs to be activated.)
  • FIX: Timezone was overwritten by country data even though the maxmind data had already detected a timezone.
  • ADD: If the manual datasource is used, the file will continue to be found if the site is moved to another host
  • Maxmind vendor code was updated to the current version (2.6.0).
  • PHP 5.4 is now required (due to the maxmind library).


  • ADD: The options array of geoip_detect2_get_info_from_ip now has a new parameter for overriding the current source for a single lookup. See API usage examples
  • ADD: New filter geoip_detect2_shortcode_country_select_countries for the country list of [geoip_detect2_countries]
  • ADD: New constant GEOIP_DETECT_IP_EMPTY_CACHE_TIME that can be used to specify a shorter cache time in case temporarily no external IP was found.
  • FIX: Compatibility with CF 4.6 (remove deprecated function call)
  • Maxmind vendor code was updated to the current version (2.4.5).


  • ADD: New datasources for Cloudflare & Amazon AWS CloudFront (countries for current IP only).
  • ADD: Country information (names, lat/lon, continent, localized in the different languages) are now filled in for sources that only detect the country code (Cloudflare, Amazon,
  • ADD: 2 shortcodes for Contact Form 7 (a select with all countries [geoip_detect2_countries mycountry], and tracking information for the email text [geoip_detect2_user_info]) – see Documentation
  • FIX: Cron scheduling is checked every time you visit the plugin page.
  • FIX: Timezones of US & Canada are now detected more often (if country+state is known)
  • FIX: Shortcode didn’t use current sitelang as default, but always english
  • Maxmind vendor code was updated to the current version (2.4.2).


  • ADD: Shortcodes can now optionally specifiy the IP: [geoip_detect2 property="country.isoCode" ip="(ipv4 or ipv6)"]
  • ADD: Plugin is now translated into German.
  • FIX: geoip_detect2_get_info_from_current_ip() now also handles the case when REMOTE_ADDR contains multiple IP adresses


  • FIX: Removed noticed concerning open_basedir.


  • Clean-up changes to prepare plugin translation.
  • FIX: Only show the “no database installed” admin notice to admins (props @meitar)


  • FIX: Manual datasource filepath handling corrected.
  • FIX: Potential incompability with BuddyPress removed.


  • FIX: (Security) Add nonces to backend to avoid CSRF (thanks to Gerard Arall).
  • FIX: Do not use PHP shortcode tags (<?=) as some servers do not support it with PHP 5.3
  • Maxmind vendor code was updated to the current version (2.3.3).


  • FIX: Also disallow proxy caching via HTTP header, if possible.
  • NEW: Shortcodes for the other API functions: [geoip_detect2_get_current_source_description], [geoip_detect2_get_client_ip], and [geoip_detect2_get_external_ip_adress]
  • FIX: geoip_detect2_get_external_ip_adress() : do not filter if $unfiltered is true.


  • FIX: Upgrade script did change the source.
  • FIX: Page caching is only disabled on upgrade when set_css_country is disabled.


  • CHANGE: The parameter $skipCache is now $options[‘skipCache’]. Using $skipCache is deprecated, but still works.
  • NEW: $options[‘timeout’] for Web-API lookups can now be specified.
  • FIX: did not set traits->ipAddress
  • FIX: does not include data for IPv6. Add a lookup error message.
  • NEW: Disable page caching if geoip-API was called (this is configurable in the options). (Supported plugins: WP Super Cache, W3 Total Cache, ZenCache, and possibly others)
  • Maxmind vendor code was updated to the current version (2.3.1).


  • FIX: Options Page: The checkboxes didn’t show (even though the option was saved) since 2.4.0
  • NEW: A fixed external IP can now be specified on the options page. (Useful in development scenarios without internet, or mixed internet/intranet cases. You can also use this to speed up things on the production server if you know the IP will not change.)
  • NEW: Hidden feature/side-effect: Clicking on save in the General Options section also empties the external IP cache.


  • FIX: Trim whitespace of IP adress.
  • FIX: some PHP notices.
  • FIX: The Installation message “No database installed” failed to install the Maxmind database since 2.4.0
  • NEW: Show IPv6-not-supported notice.
  • FIX: Add empty fallback functions in case the plugin requirements are not met. (To avoid fatal errors.)


  • FIX: Revert IPv6 check. (Sorry for this. I thought PHP compiled without IPv6 would be esoteric.)


This is a major refactor in order to support multiple sources properly. The Lookup and the Options were seperated into 2 screens (accessible in the menu under Tools and Options, respectively.)

  • NEW: Add a Cache for Web-API-Requests. Consequently, the function geoip_detect2_get_info_from_ip() received a new parameter “$skipCache” to skip this cache if not needed. You can check if the result is coming from the cache by checking $result->extra->cached (it is 0 when not cached, UNIX timestamp of cache event otherwise).
  • This also applies to the shortcode API ([geoip_detect2 property="extra.cached" skip_cache="true"])
  • NEW: Error messages during lookup are now in $record->extra->error.
  • NEW: Experimental support for the Maxmind Precision API.
  • NEW: Shortcodes now also support fallback languages. ([geoip_detect2 property="country" lang="fr,de"])
  • FIX: Check for IPv6 support for PHP.
  • FIX: Country data now also get timezones.


  • NEW: API function geoip_detect2_get_current_source_description() (as there are different sources to choose from now)
  • FIX: Show error message if PHP < 5.3 (instead of fatal error)


  • NEW: Add


  • FIX: Update Maxmind Reader to 1.0.3 (fixing issues when the PHP extension mbstring was not installed)
  • NEW: Commercial databases are now supported. You can specify a file path in the options.
  • NEW: A country database (lite or commercial) database now works as well.
  • NEW: License is now displayed before install.


  • FIX: Show error message if PHP < 5.3 (instead of fatal error)
  • FIX: Support multiple proxies (but currently only one reverse proxy)


  • FIX: Notice “Database missing” should not show during/right after database update.


  • NEW: A nagging admin notice shows up on every wp-admin page when no database is installed (yet).


  • NEW: Using v2 version of the API.
    See Migration Guide at Github

Other changes:

  • NEW: The v2-functions now support location names in other locales. By default, they return the current site language if possible.
  • NEW: The new shortcode [geoip_detect2 …] also supports a “lang”-Attribute.
  • NEW: IPv6 addresses are now supported as well.
  • Legacy function names and shortcode should work in most cases. For details check the guide above.


(Was not released on to make sure that development releases get this update as well.)


  • NEW: Support reverse proxies (you have to enable it in the plugin options.)
  • NEW: Shortcode now has a default value when no information for this IP found.


  • FIX: Fatal error on cron run


  • FIX: Schedule Database update to do in background immediately after plugin installation/re-activation.
  • FIX: Longitude can be smaller than -90


  • NEW: Can add a country- and continent-specific class on the body tag. You need to activate this in the options.
  • FIX: Automatic weekly update. (Didn’t work on all installations).
  • FIX: Do not include Maxmind Libraries again if already included by another plugin/theme


  • FIX: Automatic weekly update. Go to the plugin page (Tools menu) to verify that an update is planned.


  • Feature: Add shortcode [geoip_detect property=”(property name)”] for direct use in posts/pages


  • FIX: Manual install works again (was broken since 1.2)


  • FIX: property region_name is now filled again (was broken since 1.1)


  • Add function geoip_detect_get_external_ip_adress(): Ask a webservice to tell me the external IP of the webserver.
  • New filter: When developing locally, the external IP is used to determine the geographic location.


  • First working release.