Use IP2Location geolocation database to lookup for accurate visitor location in Matomo (Piwik) 2.0. It enables the user to find the country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation and usage type that any IP address or hostname originates from.
Branch: master
Clone or download
Latest commit cdda13b Sep 20, 2018

IP2Location Matomo (Piwik)

Latest Stable Version Total Downloads


This IP2Location plugin enables more accurate location lookup in your Matomo (Piwik) visitor log.

You need a IP2Location BIN database to make this plugin works. Database is available for free at or for a commercial database.

Installation / Update



How to I configure the plugin?

Login as administrator, then go to System > IP2Location.

Where to download IP2Location database?

You can download IP2Location database for free at or commercial version from

Can I use IP2Location Web service?

Yes, please purchase credits from and insert your API key in the settings page.

Change Log


  • Added instructions for automated IP2Location database update.


  • Added screenshot and FAQ.


  • Bugs and typos fixed.


  • Updated version number.


  • Removed testing data.


  • Added IP2Location settings menu.

  • Added support for IP2Location Web service.


  • Removed compatibilities with Piwik 2.x. Version 2.3.0 is the last version supporting Piwik 2.x.

  • Prevented plugin from overwrite existing location provider.

  • Appeared as a separated location provider under admin area.

  • Supported visitor log and live view directly in admin area.

  • Database file no longer stored within plugin folder to prevent deletion/modification during updates.

  • Database file is stored in /path/to/piwik/misc/ starting this version.


  • Fixed error when BIN file is not readable. Added backward compatible.


  • Updated to IP2Location PHP 8.0.2 library.


  • Added custom report to view additional information such as Time Zone, ZIP code, usage type.


  • Updated to IP2Location 7.0.0 library


  • First release for Piwik 2.0

IPv4 BIN vs IPv6 BIN

Use the IPv4 BIN file if you just need to query IPv4 addresses.

Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.


GPL v3 / fair use


Website: Email: