IP2Location Variables
This useful library makes it easy to conveniently find website visitors location and provides geographic information based on IP address lookup. It also can be used to display geo-data info in posts for specific…
Solid choice
IP2Location Variables is a solid plugin choice in 2026, with a few things worth checking first. It runs on 100+ sites, is rated 2.3/5 and was last updated 1 month ago, and scores 63/100 on our health check.
- Tested with the latest WordPress (7.1)
- Small user base (100+ active installs)
- Low rating so far — 2.3/5 from only 3 reviews
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where IP2Location Variables stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| geo-targeting | #33 |
| geolocation | >100 |
| ip2location | #4 |
| ip2location library | #4 |
| targeted content | #40 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 2.3 from 3 reviews
About IP2Location Variables
From the official readme · v2.10.1Description
This useful library makes it easy to conveniently find website visitors location and provides geographic information based on IP address lookup. It also can be used to display geo-data info in posts for specific locations and to help you create geo-target marketing campaigns.
It is a library derived from https://www.ip2location.com/developers/php but works as a WordPress plugin to simplify the setup and ease the integration work. It supports both the IPv4 and IPv6 address.
Below are the geolocation information you can retrieve from this library:
* Country code
* Country name
* Country flag
* Region name
* City name
* Latitude and longitude
* ZIP code
* ISP
* Domain name
* Time zone
* Net speed
* IDD code
* Area code
* Weather station code & name
* MNC, MCC, mobile carrier name
* Elevation
* Usage type
* Address type
* Category
* District
* AS Number
* AS Name
* AS Domain
* AS Usage Type
* AS CIDR
This plugin supports both IP2Location IP geolocation BIN data and web service for geolocation queries. If you are using the BIN data, you can update the BIN data every month by using the wizard on the settings page for the most accurate result. Alternatively, you can also manually download and update the BIN data file using the below links:
BIN file download: IP2Location Commercial database | IP2Location LITE database (free edition)
If you are using the IP2Location IP geolocation web service, please visit IP2Location Web Service for details.
Usage
Call the function ip2location_get_vars() in any pages, plugins, or themes to retrieve IP2Location variables. The variables are returned in object. To use lookup for a custom IP, use ip2location_get_vars(‘IP_ADDRESS’);
More Information
Please visit us at https://www.ip2location.com
Installation
We always recommend the automatic installation via the plugin menu. In case you having the difficulties to do so, below are the manual install steps:
- Upload
ip2locationfolder to the/wp-content/plugins/directory. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- You can now start using IP2Location Variables to customize your contents.
Please take note that this plugin requires minimum PHP version 5.4.
Changelog
- 2.10.1 Tested up to WordPress 7.1.
- 2.10.0 Added district, AS number, AS name, AS domain, AS usage type and AS CIDR variables.
- 2.9.10 Tested up to WordPress 7.0.
- 2.9.9 Tested up to WordPress 6.9.
- 2.9.8 Security fixes.
- 2.9.7 Tested up to WordPress 6.8.
- 2.9.6 Fixed CSRF vulnerabilities.
- 2.9.5 Fixed web service validation error when insert both IP2Location and IP2Location.io keys.
- 2.9.4 Tested up to WordPress 6.7.
- 2.9.3 Sanitized input fields.
- 2.9.2 Tested up to WordPress 6.6.
- 2.9.1 Tested up to WordPress 6.5.1.
- 2.9.0 Added ip2location.io web service support.
- 2.8.7 Tested up to WordPress 6.4
- 2.8.5 Fixed connection error.
- 2.8.4 Tested up to WordPress 6.1.
- 2.8.3 Tested up to WordPress 6.0.
- 2.8.2 Enhanced checking.
- 2.8.1 Tested up to WordPress 5.9.
- 2.8.0 Added new address type and category fields.
- 2.7.3 Tested up to WordPress 5.8.
- 2.7.2 Tested up to WordPress 5.7.
- 2.7.1 Tested up to WordPress 5.6.
- 2.7.0 Minor bug fixes and added supports up to DB24.
- 2.6.0 Updated file structures to use composer for IP2Location libraries.
- 2.5.12 Tested with WordPress 5.5.
- 2.5.11 Fixed parsing issues.
- 2.5.10 Tested with WordPress 5.4.
- 2.5.9 Increased download timeout.
- 2.5.8 Fixed typo.
- 2.5.7 Minor fixes.
- 2.5.6 Added feedback request.
- 2.5.5 Tested with WordPress 5.3.2.
- 2.5.4 Fixed variable errors when result not found.
- 2.5.3 Updated IP2Location library.
- 2.5.2 Updated documentation links.
- 2.5.1 Tested up to WordPress 5.1.1.
- 2.5.0 Upgraded IP2Location API to v2.
- 2.4.0 Added debug log.
- 2.3.1 Minor changes.
- 2.3.0 IP2Location database update changed to use download token.
- 2.2.0 Able to lookup specific IP address.
- 2.1.1 Fixed conflicts when multiple IP2Location plugins installed.
- 2.1.0 Use IP2Location PHP 8.0.2 library for lookup.
- 2.0.8 Use latest IP2Location library for lookup.
- 2.0.7 Fixed close sticky information panel issue.
- 2.0.6 Use latest IP2Location library and updated the setting page.
- 2.0.5 Fixed error when creating admin option.
- 2.0.4 Fixed uninstall hook warning message.
- 2.0.3 Fixed uninstall hook.
- 2.0.2 Fixed empty variable on first load.
- 2.0.1 Tested with WordPress 4.4.
- 2.0.0 Added suport to IP2Location Web Service. Rewrote the codes behind.
- 1.1 Support automated bin download and server variables for IP2Location.
- 1.0 Initial release
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best IP2Location Variables alternatives
All geo-targeting plugins →FAQ
IP2Location Variables: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 4, 2026
Is IP2Location Variables free?
Yes. IP2Location Variables is free to download and use from the official WordPress.org plugin directory.
Is IP2Location Variables safe to use in 2026?
IP2Location Variables is a solid plugin choice in 2026, with a few things worth checking first. It runs on 100+ sites, is rated 2.3/5 and was last updated 1 month ago, and scores 63/100 on our health check.
How many websites use IP2Location Variables?
IP2Location Variables is active on 100+ WordPress websites and has been downloaded 13,370 times since it launched in September 2013. It was downloaded 206 times in the last 30 days.
Does IP2Location Variables work with WordPress 7.1?
Yes. The developer has tested IP2Location Variables up to WordPress 7.1.2, the latest release. It requires WordPress 2.0 or newer.
When was IP2Location Variables last updated?
The latest version, 2.10.1, was released on August 21, 2026 (1 month ago).
Who makes IP2Location Variables?
IP2Location Variables is developed and maintained by IP2Location.
What are the best alternatives to IP2Location Variables?
The most popular alternatives to IP2Location Variables are belingoGeo (1K+ installs), IP2Location Tags (200+ installs) and Geo Content (100+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card